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PREFACE 

This manual describes the resident Operating System (OS) for the 
ATARI@ Home Computer^ for readers who are familiar with the 
internal behavior of the system. It discusses: 

o System functions and utilization techniques 

o Subsystem relationships and organization 

o Characteristics of the ATARI peripheral devices that can 
be attached to the ATARI400CTM3 and ATARI 800CTM3 Home 
Computer 

o Advanced techniques for going beyond the basic OS 
capabi lities 

o The general features of the computer system hardware used 
by the OS. 

It would be helpful to have a familiarity with programming concepts 
and terminology^ assembly language programming in general# the 
Synertek 6502 in particular/ and digital hardware concepts and 
terminology. you will be provided with the information you need to 
use the OS resources, without resorting to tr ial-and-error techniques 
or the OS listing. Supporting information for tasks that involve OS 
listing references is also provided. 

This manual does not present a comprehensive description of the 
hardware used to provide OS capabilites. The programmer who needs to 
go beyond the capabilities described should consult the ATARI Home 
Computer Hardware Manual. 
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1 INTRODUCTION 

GENERAL DESCRIPTION OF THE ATARI HOME COMPUTER SYSTEM 

Operating systems in the ATARI© 400CTM3 and ATARI 800CTM]I Home 
Computer are identical. The primary differences between the two are 

a Physical packaging 

o The ATARI 400 Computer console has one cartridge slot/ the 
ATARI 800 Computer console has two cartridge slots 

o The ATARI 400 Home Computer contains 16K RAM and cannot be 
expanded. The ATARI 800 Home Computer can be expanded to a 
maximum of 48K RAM. 

o The ATARI 800 Computer has a monitor jack; the ATARI 400 
Computer does not. 

The Hardware Circuitry 

o Produces both character and point graphics for black and 
white (B/W) or color television. 

o Produces four independent audio channels (frequency 
controlled) which use the television sound system. 

o Provides one bi-level audio output in the base unit. 

o Interfaces with up to four Joysticks and eight Paddle 
Controllers. 

o Interfaces with a serial I/O bus for expansion. 

o Contains a built-in keyboard 

Figure 1-1 presents a simplified block diagram of the hardware. 
See the hardware manual for supporting documentation. 
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CONVENTIONS USED IN THIS MANUAL 

This manual uses the follouiing special notations: 

Hexadecimal Numbers 

All two-digit numbers preceded by a dollar sign (*) designate 
hexadecimal numbers. All other numbers (except memory addresses) 
are in decimal form unless otherwise specified in the supporting 
text. 

Memory Addresses 

All references to computer memory and mapped I/O locations are in 
hexadecimal notation. Memory addresses may or may not be contained 
in square brackets. (Example: CD20F3 and D20F are the same 
address. ) 



Kilobytes of Memory 

Memory sizes are frequently expressed in units of kilobytes/ 
as 32K/ where a kilobyte is 1024 bytes of memory. 



such 



PASCAL As an Algorithm-Specification Language 

The PASCAL language (procedure block only) is used as the 
specification language in the few places where an algorithm is 
specified in detail. PASCAL syntax is similar to any number of 
other block-structured languages^ and you should have no 
difficulty following the code presented. 



Memory Layouts 

Diagrams similar to Figure 1-2 are used whenever pictures of bytes 
or tables are presented: 



7 6 5 4 3 2 10 

-♦—+—•♦—♦■•—♦•■—♦• — h — h— ♦• 



+—+—♦—+-+—♦—+—♦•—+• 



This is a single byte. 

+ This is a word (2 bytes) 



+-+-.4.-..^-.4.-.4.-.4._-+.«4. 



-a This is a block of memory 

of unspecified length. 



+-+ — h~+--+--+--+ — I— + 
Figure 1-2. Memory Layout Chart 
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Bit 7 is the most significant bit (MSB) o-f the byte/ and Bit 
is the least significant bit (LSB). 

In tables and figures/ memory addresses always increase toward the 
bottom of the figure. 

Backus-Naur Form 

A modified version of Backus-Naur Form (BNF) is used to express some 
syntactic forms/ uihere the following metalinguistic symbols are used 

::= is the substitution (assignment) operator. 

< > a metasyntactic variable. 

I separates alternative substitutions. 

C 3 an optional construct. 

Anything else is a syntactic literal constant/ which stands for 
itself. 

For Example: 

<device specif ication> ::= <device name>C<device number>3: 

<device name> ::= C IDIEIKIP !R IS 

<iievice number> ::= 1 1213{4! 5I6I7I8 



A "device specification" consists of a mandatory "device name/" 
followed by an optional "device number/" followed by the mandatory 
colon character. The device name in turn must be one of the 
characters shown as alternatives. The device number (if it is present) 
must be a digit 1 through 8. 

OS Eq.uate Filenames 

Operating System ROM (Read Only Memory) and RAM (Random Access 
Memory) vector names* RAM database variable names and hardware 
register names are all referred to by the names assigned in the OS 
program equate list. When one of these names is used/ the memory 
address is usually provided/ such as BOOTAD C02423. 
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2 OPERATING SYSTEM FUNCTIONAL ORGANIZATION 

This section describes the various subsystems of the resident OS in 
general terms. 

Input/Output Subsystem 

The Input/Output (I/O) subsystem provides a high-level interface 
betuieen the programs and the hardware. Most functions are 
device-independent* such as the reading and writing of character data; 
yet provisions have been made for device-dependent functions as well. 
All peripheral devices capable of dealing with character data have 
individual symbolic names (such as KtD,Pi etc), and can be accessed 
using a Central I/O (CIO) routine. 

A RAM data base provides access to controllers (joysticks and paddle 
controllers)* which do not deal with character data. This RAM data 
base is periodically updated to show the states of these devices. 

INTERRUPT PROCESSING 

The interrupt system handles all hardware interrupts in a common 
and consistent manner. By default* all interrupts are fielded by 
the OS. At your discretion* individual interrupts (or 
groups of interrupts) can be fielded by the application program. 

INITIALIZATION 

The system provides two levels of initialization: power up and 
system reset. The OS performs power-up initialization each time 
the system power is switched to ON* and system reset 
initialization is performed each time the C SYSTEM. RESET 3 key is 
pressed. 

Power-Up 

The OS examines and notes the configuration of the unit whenever 

the system power is switched to ON. The system performs the following 

tasks at power up: 
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o Determines the highest RAM address. 

o Clears all of RAM to zeros. 

o Establishes all RAM interrupt vectors. 

o Formats the device table. 

o Initializes the cartridge(s ). 

o Sets up the screen for 24 x 40 text mode. 

o Boots the cassette if directed. 

o Checks cartridge slot(s> for diskette-boot instructions. 

o Boots the diskette if directed to do so and a disk drive unit 
is attached. 

o Transfers control to the cartridge^ diskette-booted program^ 
cassette-booted program, or blackboard program. 

C SYSTEM. RESET 3 

Pressing the C SYSTEM. RESET 3 key causes the OS to perform these 
following tasks: 

o Clears the OS portion of RAM. 

o Rechecks top of RAM. 

o Reestablishes all RAM interrupt vectors. 

o Formats the device table. 

o Initializes the cartr idge<s > . 

o Sets up the screen for 24 x 40 text mode. 

o Transfers control to the cartridge, a diskette-booted program, 
a cassette-booted program, or the blackboard program. 

Note that CSYSTEM. RESET! does not perform all the pouier-up 
tasks listed in the pouier-up section. 
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FLOATING POINT ARITHMETIC PACKAGE 

The OS ROM contains a Floating Point (FP) package that is available 
to nonresident programs such as ATARI BASIC. 

The package is not used by the other parts of the OS itself. The 
floating point numbers are stored as 10 BCD digits of mantissa/ plus a 
i-byte exponent. The package contains these routines: 

o ASCII-to-FP and FP-to-ASCI I conversion. 

o Integer-to~FP and FP-to-integer conversion. 

o FP addi subtract* multiply and divide. 

o FP log* expi and polynomial evaluation. 

o FP number clear* load* store* and move. 
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You set these 2--bytes. They contain information that is 
used by the OPEN command process and/or is device-dependent. 

For OPEN/ two bits of ICAXl are always used to specify the OPEN 
direction as shown below* where R is set to 1 for input (read) 
enable and W is set to 1 for output (write) enable. 



7 3 2 

< I I I I rf I r( I t I 
4— +~+— ♦—+—+--+•— ♦•—+ 

ICAXl is not altered by CIO. You should not alter ICAXl 
once the device/file is open. 

The remaining bits of ICAXl and all of ICAX2 contain only 
device-dependent data and are explained later in this section. 

Remaining Bytes ( ICAX3-ICAX6) 

The handler reserves the four remaining bytes for processing the 
I/O command for CIO. There is no fixed use for these bytes. They 
are not user-alterable except as specified by the particular 
device descriptions. These bytes will be referred to as ICAX3* 
ICAX4, ICAX5 and ICAX6» although there are no equates for those 
names in the OS equate file. 



CIO Functions 

The CIO supports records and blocks and the handlers support 
single bytes. All of the system handlers support one or more 
of the eight basic functions subject to restrictions based 
upon the direction of data transfer (e.g. one cannot read data 
from the printer). The basic functions are: OPEN* CLOSE* GET 
CHARACTERS, PUT CHARACTERS* GET RECORD, PUT RECORD* GET STATUS* 
and SPECIAL. 



OPEN — Assign Device/Filename to lOCB and Ready for Access 

A device/file must be opened before it can be accessed. This 
process links a specific lOCB to the appropriate device 
handler* initializes the device/file* initializes all CIO 
control variables, and passes device-specific options to the 
device handler. 
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You set up the following lOCB parameters prior to calling CIO for an 
OPEN operation: 

COMMAND BYTE = *03 

BUFFER ADDRESS *= pointer to a device/filename specification. 

AUXl = OPEN direction bits/ plus device-dependent information. 

AUX2 = device-dependent information. 

After an OPEN operation* CIO will have altered the following lOCB 
parameters: 

HANDLER ID = index to the system device table; this is 
used only by CIO and must not be altered. 

DEVICE NUMBER = device number taken from the device/filename 
specification and must not be altered. 

STATUS = result of OPEN operation; see Appendix B for a list 
of the possible status codes. In general* a negative status 
will indicate a failure to open properly. 

PUT ADDRESS = pointer to the PUT CHARACTERS routine for the 
device handler just opened. 

It is recommended that this pointer not be used. 



CLOSE — Terminate Access to Device/File and Release lOCB. 

You issue a CLOSE command after you are through accessing a 
given device/file. The CLOSE process completes any pending data 
writes/ goes to the device handler for any device-specific 
actions/ and then releases the lOCB. 

You set the following lOCB parameter prior to calling 
CIO: 

COMMAND BYTE = *0C 

The CIO alters the following lOCB parameters as a result of the 
CLOSE operation: 

HANDLER ID = %FF 

STATUS = Result of CLOSE operation. 

PUT ADDRESS = pointer to "lOCB not OPEN" routine. 
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GET CHARACTERS — Read n Characters (Byte-Aligned Access) 

The specified number of characters are read from the device/file 
to the user-supplied buffer. EOL characters have no termination 
features when using this function; there can be no EOL# or many 
EOL'Si in the buffer after operation completion. There is a 
special case provided that passes a single byte of data in the 
6502 A register when the buffer length is set to zero. 

You set the following lOCB parameters prior to calling CIO: 

COMMAND BYTE = $07 

BUFFER ADDRESS = pointer to data buffer. 

BUFFER LENGTH = number of bytes to veaiii if this is zero# 
the data will be returned in the 6502 A register only. 

The CIO alters the following lOCB parameters as a result of the 
GET CHARACTERS operation: 

STATUS « result of GET CHARACTERS operation. 

BYTE COUNT/BUFFER LENGTH = number of bytes read to the 
buffer. The BYTE COUNT will always equal the BUFFER LENGTH 
except when an error or an end-of-file condition occurs. 



PUT CHARACTERS — Write n Characters (Byte-Aligned Access) 

The specified number of characters are written from the user-supplied 
buffer to the device/file. EOL characters have no buffer 
terminating properties^ although they have their standard meaning 
to the device/file receiving them; no EOL's are generated by CIO. 
There is a special case that allows a single character to be 
passed to CIO in the 6502 A register if the buffer length is 
zero. 

You set the following lOCB parameters prior to initiating the PUT 
CHARACTERS operation: 

COMMAND BYTE = *0B 

BUFFER ADDRESS = pointer to data buffer. 

BUFFER LENGTH = number of bytes of data in buffer. 

The CIO alters the following lOCB parameter as a result of the 
PUT CHARACTERS operation: 

STATUS « result of PUT CHARACTERS operation. 
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GET RECORD — Read Up To n Characters <Record~Al igned Access) 

Characters are read from the device/file to the user-supplied 
buffer until either the buffer is full or an EOL character is 
reBd and put into the buffer. If the buffer fills before an EOL 
is readi then the CIO continues reading characters from the 
device/file until an EOL is read,, and sets the status to 
indicate that a truncated record was read. No EOL will be put at 
the end of the buffer. 

You set the following lOCB parameters prior to calling CIO: 

COMMAND BYTE = *05 

BUFFER ADDRESS « pointer to data buffer. 

BUFFER LENGTH = maximum number of bytes to read (including 
the EOL character). 

The CIO alters the following lOCB parameters as a result of the 
GET RECORD operation: 

STATUS = result of GET RECORD operation. 

BYTE COUNT/BUFFER LENGTH = number of bytes read to data 
buffer; this can be less than the maximum buffer length. 



PUT RECORD — Write Up To n Characters (Record-Aligned Access) 

Characters are written from the user-supplied buffer to the 
device/file until either the buffer is empty or an EOL character 
is written. If the buffer is emptied without writing an EOL 
character to the device/file* then CIO will send an EOL after the 
last user-supplied character. 

You set the following lOCB parameters prior to calling CIO: 

COMMAND BYTE = *09 

BUFFER ADDRESS = pointer to data buffer. 

BUFFER LENGTH = maximum number of bytes in buffer. 

The CIO alters the following lOCB parameter as a result of the 
PUT RECORD operation: 

STATUS = result of PUT RECORD operation. 
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GET STATUS — Return Device-Dependent Status Bytes 

The device controller is sent a STATUS command/ and the 
controller returns four bytes of status information that are 
stored in DVSTAT C02EA3. 

You set the following lOCB parameters prior to calling CIO: 

COMMAND BYTE = *0D 

BUFFER ADDRESS = pointer to a device/filename specification 
if the lOCB is not already OPEN; see the discussion of the 
implied OPEN option below. 

After a GET STATUS operation/ CIO will have altered the following 
parameters: 

STATUS = result of GET STATUS operation/ see Appendix B for 
a list of the possible status codes. 

DVSTAT = the four-byte response from the device controller. 



SPECIAL — Special Function 

Any command byte value greater than %0D is treated by CIO as a 
special case. Since CIO does not know what the function isi CIO 
transfers control to the device handler for complete processing 
of the operation. 

The user sets the following lOCB parameters prior to 
calling CIO: 

COMMAND BYTE > *0D 

BUFFER ADDRESS = pointer to a device/filename specification 
if the lOCB is not already open; see the discussion of the 
implied OPEN option below. 

Other lOCB bytes can be set up* depending upon the specific 
SPECIAL command being performed. 

After a SPECIAL operation* CIO will have altered the following 
parameters: 

STATUS = result of SPECIAL operation; see Appendix B for a 
list of the possible status codes. 

Other bytes can be altered/ depending upon the specific 
SPECIAL command. 
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Implied OPEN Option 

The GET STATUS and SPECIAL commands are treated specially by ClOi 
they can use an already open lOCB to initiate the process or they 
can use an unopened lOCB. If the IOCS is unopened/ then the 
buffer address must contain a pointer to a device/filename 
specif ication# just as for the OPEN command; CIO will then open 
that lOCBf perform the specified command and then close the lOCB 
again. 



Device/Filename Specification 

As part of the OPEN command/ the IOCS buffer address parameter 
points to a device/filename specif ication* that is a string of 
ATASCII characters in the following format: 

<spec if ication> ::« <device>C<number>3 : CCf i lename>3<eol> 

<device> ::= C IDIEIKIP {R I S 

<number> ::= 1I2I3I4I5I6I7I8 

<filename> has device-dependent characteristics. 

<eol> : ;= *9B 

The following devices are supported at this writing: 

C = Cassette drive 

Dl through D8 = Floppy diskette drives * 

E = Screen Editor 

K = Keyboard 

P = 40~column printer 

P2 = 80— column printer * 

Rl through R4 = RS-232-C interfaces * 

S = Screen display 

Devices flagged by asterisks <*> are supported by nonresident 
handlers. 

If <number> is not specified/ it is assumed to be 1. 

The following examples show valid device/filename specifications: 



D2: BDAT 

D:HOLD 

K: 



Cassette 

File "BDAT" on disk drive #2 

File "HOLD" on disk drive #1 

Keyboard 
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I/O Example 

The example provided in this section illustrates a simple example of 
an I/O operation using the CIO routine. 



This code segment illustrates the simple example of reading 
text lines (records) from a diskette file named TESTER on disk 
drive #i. All symbols used are equated <tiithin the program 
although many of the symbols are in the OS equate file. 

The program performs the following steps: 

1. Opens the file 'Dl: TESTER' using IOCS #3. 

2. Reads records until an error or EOF is reached. 

3. Closes the file. 

I/O EQUATES 



EOL= 


*9B 


I0CB3= 


*30 


ICHID= 


*0340 


ICDNO« 


ICHID+1 


ICCOM* 


ICDNO+1 


ICSTAa 


ICCOM+1 


ICBAL= 


ICSTA+1 


ICBAH= 


ICBAL+1 


ICPTL= 


ICBAH+1 


ICPTH= 


ICPTL+1 


ICBLL= 


ICPTH+1 


ICBLH« 


ICBLL+1 


ICAX1= 


ICBLH+1 


ICAX2= 


ICAXl+1 


OPEN« 


*03 


OETREC= 


*05 


CLOSE* 


*0C 


OREAD" 


*04 


OWRIT= 


»08 


EOF* 


!^88 


CIOV« 


*E456 



END OF LINE CHARACTER. 

lOCB #3 OFFSET (FROM lOCB #0) 

(HANDLER ID — SET BY CIO). 
(DEVICE # -— SET BY CIO). 
COMMAND BYTE. 

STATUS BYTE — SET BY CIO. 
BUFFER ADDRESS (LOW). 
BUFFER ADDRESS (HIGH). 



BUFFER LENGTH (LOW). 
BUFFER LENGTH (HIGH). 
AUX 1. 
AUX 2. 

OPEN COMMAND. 

GET RECORD COMMAND. 

CLOSE COMMAND. 

OPEN DIRECTION = READ. 
OPEN DIRECTION « WRITE. 

END OF FILE STATUS VALUE. 

CIO ENTRY VECTOR ADDRESS. 



FIRST INITIALIZE THE lOCB FOR FILE "OPEN" 



LDX #I0CB3 / SETUP TO ACCESS lOCB #3. 
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LDA 


#OPEN 


STA 


ICCOM, X 


LDA 


#NAME 


STA 


ICBAL, X 


LDA 


#NAME/256 


STA 


ICBAH, X 


LDA 


#OREAD 


STA 


ICAXli X 


LDA 


#0 


STA 


ICAX2. X 



; SETUP OPEN COMMAND. 



; SETUP BUFFER POINTER TO 
; . . . POINT TO FILENAME. 



; SETUP FOR OPEN READ. 



; CLEAR AUX 2. 



"OPEN" THE FILE. 



JSR 
BPL 

JMP 



CIOV 
TPIO 

ERROR 



PERFORM "OPEN" OPERATION. 
STATUS WAS POSITIVE -- OK. 

NO -- "OPEN" PROBLEM. 



SETUP TO READ A RECORD. 



TPIO 



LDA 


#GETREC 


STA 


ICCOM, X 


LDA 


#BUFF 


STA 


ICBAL. X 


LDA 


#BUFF/256 


STA 


ICBAH, X 



i SETUP "GET RECORD" COMMAND. 



; SETUP DATA BUFFER POINTER. 



READ RECORDS. 



LOOP 



LDA 


#BUFFSZ 


STA 


ICBLL, X 


LDA 


#BUFFSZ/256 


STA 


ICBLH, X 


JSR 


CIOV 


BMI 


TP20 



SETUP MAX RECORD SIZE . . 
. . . PRIOR TO EVERY READ. 



READ A RECORD. 

MAY BE END OF FILE. 



; A RECORD IS NOW IN THE DATA BUFFER "BUFF". IT IS TERMINATED BY 
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AN EOL CHARACTER, AND THE RECORD LENGTH IS IN "ICBLL" and "ICBLH" 
THIS EXAMPLE WILL DO NOTHING WITH THE RECORD JUST READ. 



JMP 



LOOP 



; READ NEXT RECORD. 



NEGATIVE STATUS ON READ — CHECK FOR END OF FILE. 



TP20 



CPY 


#EOF 


BNE 


ERROR 


LDA 


#CLOSE 


STA 


ICCOM, X 


JSR 


CIOV 


JMP 


« 



; END OF FILE STATUS? 
i NO — ERROR. 

i YES -- CLOSE FILE. 



} CLOSE THE FILE. 

; *** END OF PROGRAM *** 



DATA REGION OF EXAMPLE PROGRAM 



NAME 



. BYTE "Dl : TESTER", EOL 



BUFFSZ= 


80 


BUFF= 


* 


*= 


*+BUFFSZ 




. END 



; 80 CHARACTER RECORD MAX 

(INCLUDES EOL) 

; READ BUFFER. 



Figure 5-3 An I/O Example 
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Device-Specific Information 

This section provides device-specific information regarding the 
device handlers that interface to CIO. 



Keyboard Handler (K: ) 

The keyboard device is a read only device with a handler that 
supports the following CIO functions: 



OPEN 

CLOSE 

GET CHARACTERS 

GET RECORD 

GET STATUS (null function) 



The Keyboard Handler can produce the following error statuses 



*80 — CBREAK3 key abort. 

*88 — end-of-file (produced by pressing CCTRL3 3). 



The Keyboard Handler is one of the resident handlers. It has a 
set of device vectors starting at location E420. 

The keyboard can produce any of the 256 codes in the ATASCII 
character set (see Appendix F). Note that a few of the keyboard 
keys do not generate data at the Keyboard Handler level. These 
keys are described below: 

C/J\3 - The ATARI key toggles a flag that enables/disables the 
inversion of bit 7 of each data character vea^. The 
Screen Editor editing keys are exempted from such 
inversion/ however. 

CAPS - The CCAPS/L0WR3 key provides three functions: 

CSHIFT3CCAPS/LOWR3 — Alpha caps lock. 
CCNTRL3CCAPS/LOWR3 — Alpha CCTRL3 lock. 
CCAPS/L0WR3 — Alpha unlock. 
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The system pouters up and uiill system reset to the alpha 
caps lock option. 

Some key combinations are ignored by the handler/ such as 
CCTRL3 4 through ECTRL3 9, CCTRL3 0, CCTRL3 1, E:CTRL3 // and 
all key combinations in that the CSHIFT3 and CCTRL3 keys are 
depressed simultaneously. 

The CCTRL3 3 key generates an EOL character and returns EOF status. 

The CBREAK3 key generates an EOL character and returns BREAK status 



CIO Function Descriptions 

The device-specific characteristics of the standard CIO functions 
(described earlier in this section) are detailed below: 

OPEN 

The device name is K/ and the handler ignores any device number 
and filename specification/ if included. 

There are no device-dependent option bits in AUXl or AUX2. 

CLOSE 
No special handler actions. 

GET CHARACTERS and GET RECORD 

The handler returns the ATASCII key codes to CIO as they are 
entered/ with no facility for editing. 

GET STATUS 
The handler does nothing but set the status to *01. 

Theory of Operation 

Pressing a keyboard key generates an IRQ interrupt and vectors to 
the Keyboard Handler's interrupt service routine (see Section 6). 
The key code for the key pressed is then vea6 and stored in data 
base variable CH C02FC3. This occurs whether or not there is an 
active read request to the Keyboard Handler/ and effects a one-byte 
FIFO for keyboard entry. See Appendix L (E8> for a discussion of 
the auto repeat feature. 
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The Keyboard Handler monitors the CH variable -for not containing 
the value ^FF (empty state) whenever there is an active read 
request for the handler. When CH shows nonemptyi the handler 
takes the key code from CH and sets CH to *FF again. The key code 
byte obtained from CH is not an ATASCII code and has the 
following form: 



7 

+—4.-4.— 4. — H-4._4._4. — J. 

'iCiSi key code i 
4. -.4. -.4. -.4.-4. -4. -.4.-4. -.4. 



Where: C ~ 1 if the CCTRL3 key is pressed. 
S = 1 if the CSHIFT3 key is pressed. 

The remaining six bits are the hardware key code. 



The key code obtained is then converted to ATASCII using the 
first of the following rules that applies: 

1. Ignore the code if the C and S bits are both set. 

2. If the C bit is seti process the key as a CCTRL3 code. 

3. If the S bit is set* process the key as a CSHIFT3 code. 

4. If CCTRL3 lock is in effect* process alpha characters as CTRL 
codes/ all others as lowercase. 

5. IF CSHIFT3 lock is in effect* process alpha characters as SHIFT 
codes* all others as lowercase. 

6. Else* process as lowercase character. 

Then: If the resultant code is not a Screen Editor control code* 
and if the video inverse flag is set* then set bit 7 of the 
ATASCII code (will cause inverse video when displayed). 
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KEY CODE TO ATASCII CONVERSION TABLE 



Key 


Key 


Lwr. 


CSHIFT3 


CCTRL3 


Key 


Key 


Lwr. 


SHIFT 


CTRL 


Code 


Cap 


Case 






Code 


Cap 


Case 






00 


L 


6C 


4C 


OC 


20 


/ 


2C 


5B 


00 


01 


J 


6A 


4A 


OA 


21 


SPACE 


20 


20 


20 


02 


/ 


3B 


3A 


7B 


22 




2E 


5D 


60 


03 


— 


— 


— 


— 


23 


N 


6E 


4E 


OE 


04 


— 


— 


— 


— 


24 


— 


— 


— 


— 


05 


K 


6B 


4B 


OB 


25 


H 


6D 


4D 


OD 


06 


+ 


2B 


5C 


IE 


26 


/ 


2F 


3F 


— 


07 


* 


2A 


5E 


IF 


27 


/{\ 


— 


— 


— 


08 





6F 


4F 


OF 


28 


R 


72 


52 


12 


09 


— 


— 


— 


— 


29 


— 


— 


— 


— 


OA 


P 


70 


50 


10 


2A 


E 


65 


45 


05 


OB 


u 


75 


55 


15 


2B 


Y 


79 


59 


19 


OC 


RET 


9B 


9B 


9B 


2C 


TAB 


7F 


9F 


9E 


OD 


I 


69 


49 


09 


2D 


T 


74 


54 


14 


OE 


~ 


2D 


5F 


IC 


2E 


W 


77 


57 


17 


OF 


ss 


3D 


7C 


ID 


2F 


G 


71 


51 


11 


10 


V 


76 


56 


16 


30 


9 


39 


28 


— 


11 


— 


— 


— 


— 


31 


— 


— 


— 


— 


12 


c 


63 


43 


03 


32 





30 


29 


— 


13 


— 


— 


— 


— 


33 


7 


37 


27 


— 


14 


— 


— 


— 


— 


34 


BACKS 


7E 


9C 


FE 


15 


B 


62 


42 


02 


35 


8 


38 


40 


— 


16 


X 


78 


58 


18 


36 


.f 


3C 


7D 


7D 


17 


Z 


7A 


5A 


lA 


37 


> 


3E 


9D 


FF 


18 


4 


34 


24 


— 


38 


F 


66 


46 


06 


19 


— 


— 


— 


— 


39 


H 


68 


48 


08 


lA 


3 


33 


23 


9B* 


3A 


D 


64 


44 


04 


IB 


6 


36 


26 


— 


3B 


— 


— 


— 


— 


IC 


CESC] 


! IB 


IB 


IB 


3C 


CAPS 


— 


— 


— 


ID 


5 


35 


25 


— 


3D 


Q 


67 


47 


07 


IE 


2 


32 


22 


FD 


3E 


S 


73 


53 


13 


IF 


1 


31 


21 


— 


3F 


A 


61 


41 


01 



«■ CCTRL3 3 returns EOF status. 

A complement o-f this table (ATASCII to keystroke) is given in 
Appendix F. 

Figure 5-4 Keycode to ATASCII Conversion Table 
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Display Handler (S: ) 

The display device is a read/write device with a handler 
that supports the following CIO functions: 



OPEN 

CLOSE 

GET CHARACTERS 

GET RECORD 

PUT CHARACTERS 

PUT RECORD 

GET STATUS (null function) 

DRAW 

FILL 



The Display Handler can produce the following error statuses: 

*84 — Invalid special command. 

*8D — Cursor out~of-range. 

*91 — Screen mode > 11. 

*93 — Not enough memory for screen mode selected. 

The Display Handler is one of the resident handlersi and 
therefore has a set of device vectors starting at location E410. 



Screen Modes 

You can operate the display screen in any of 20 
configurations <modes 1 through 8/ with or without split 
screen; plus mode 0# and modes 9 through 11 without split 
screen). Mode is the text displaying mode. Modes 1 through 
11 are all graphics modes (although modes 2 and 3 do display 
subset of the ATASCII character set). Modes 9 through 11 
req.uire a GTIA chip to be installed in place of the standard 
CTIA chip. 



TEXT MODE 

In text mode the screen is comprised of 24 lines of 40 
characters per line. Program alterable left and right margins 
limit the display area. They default to 2 and 39 (of a possible 
and 39). 
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A program-controllable cursor shows the destination of the next 
character to be output onto the screen. The cursor is visible as 
the inverse video representation of the current character at the 
destination position. 

The text screen data is internally organized as variable length 
logical lines. The internal representation is 24 lines when the 
screen is cleared. Each EOL marks the end of a logical line as 
text is sent to the screen. If more than 3 physical lines of text 
are sent/ a logical line will be formed every 3 physical lines. 
The number of physical lines used to comprise a logical line (1 
to 3> is always the minimum required to hold the data for that 
logical line. 

The text screen "scrolls" upward whenever a text line at the 
bottom row of the screen extends past the right margin^ or a text 
line at the bottom row is terminated by an EOL. Scrolling removes 
the entire logical line that starts at the top of the screen/ and 
then moves all subsequent lines upward to fill in the void. The 
cursor also moves upward/ if the logical line deleted exceeds one 
physical line. 

All data going to or coming from the text screen is represented 
in 8-bit ATASCII code as shown in Appendix E. 



TEXT MODES 1 AND 2 

In text modes 1 and 2 the screen comprises either 24 lines of 20 
characters (mode 1>/ or 12 lines of 20 characters (mode 2). The 
left and right margins are of no consequence in these modes and 
there is no visible cursor. There are no logical lines associated 
with the data and in all regards these modes are treated as 
graphics modes by the handler. 

Data going to or coming from the screen is in the form shown 
below: 



7 

+—+-4—4— +—-»—+ — >— + 

{ C { D { 
+-+-+-+-+-+-+-+-+ 

WhereiC is the color/character-set select field 
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c 


Color 


Color 




Character 


Character 


Value 


(default) 


Regist 


er 


Set 






Set 






(see 




CHBAS= 


=*E0 


CHBAS=*E2 






Append 


ix 














H) 















green 


(PFl) 




j 


— 


? 


CHEART3 


1 


gold 


(PFO) 




» 


~ 


? 


C HEART 3 


2 


gold 


(PFO) 




« 


- 




CDIAM0ND3 


3 


green 


(PFl) 




@ 


- 




CDIAM0ND3 


4 


red 


(PF3) 




1 


- 


? 


CHE ART 3 


5 


b lue 


(PF2) 




1 


- 


? 


C HEART 3 


6 


blue 


(PF2) 




@ 


-. 




CDIAM0ND3 


7 


red 


(PF3) 




@ 


~ 




C DIAMOND 3 



C ARROW 3 
t ARROW 3 
C TRIANGLE 3 
C TRIANGLE 3 
C ARROW 3 

CARR0W3 
C TRIANGLE 3 
C TRIANGLE 3 



D is a S-bit truncated ATASCII code that selects the specific 
character within the set selected by the C field. See Appendix E 
for the graphics representations of the characters. 

Data base variable CHBAS C02F43 allows for the selection of 
either of two data sets. The default value of *E0 provides the 
capital letters* numbers and punctuation characters; the 
alternate value of *E2 provides lowercase letters and the special 
character graphics set. 



Figure 5-5 Text Modes 1 and 2 Data Form 



GRAPHICS MODES (Modes 3 Through 11) 

The screen has varying physical characteristics for each of the 
graphics modes as shown in Appendix H. Depending upon the mode* 
1 to 16 color selection is available for each pixel and the 
screen size varies from 20 by 12 (lowest resolution) to 320 by 
192 (highest resolution) pixels. 

There is no visible cursor for the graphics mode output. 

Data going to or coming from the graphics screen is represented 
as 1 to 8~bit codes as shown in Appendix H and in the GET/PUT 
diagrams following. 



SPLIT-SCREEN CONFIGURATIONS 



In split-screen configurations* the bottom of the screen is 
reserved for four lines of mode text. The text region is 
controlled by the Screen Editor* and the graphics region is 
controlled by the Display handler. Two cursors are maintained 
this configuration so that the screen segments can be managed 
independently. 



m 
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To operate in split-screen mode/ the Screen Editor must first be 
opened and then the Display Handler must be opened using a 
separate lOCB (with the split-screen option bit set in AUXl). 



CIO Function Descriptions 

The device-specific characteristics of the standard CIO functions 
(described earlier in this section) are detailed below: 



OPEN 

The device name is Si and the handler ignores any device number an< 
filename specification* if included. 

The handler supports the following options: 

7 

AUXl 5 IC5S5WIRI 5 
4.-.+— 4. — J. — j.»-^ — 4. — ►-+ 

Where: C = 1 indicates to inhibit screen clear on OPEN. 

S = 1 indicates to set up a split-screen configuration (for 

modes 1 through 8 only). 
R and W are the direction bits (read and write). 

7 

4—4—4—+ — I— 4— -4—4— 4- 

AUX2 i ! mode I 

4,->4.-.4..-.4._4.-«4.>-4. — j— + 

Where: mode is the screen mode (0 through 11). 

Note: If the screen mode selected is 0/ then the AUXl C and 
S options are assumed to be 0. 

You share memory utilization with the Display Handler 
information. Sharing is necessary because the Display Handler 
dynamically allocates high address memory for use in generating 
the screen display* and because different amounts of memory are 
needed for the different screen modes. Prior to initiating an 
OPEN command the variable APPIiHI C000E3 should contain the 
highest address of RAM you need. The Screen handler 
will open the screen only if no RAM is needed at or below that 
address. 

Upon return from a screen OPEN* the variable MEMTOP C02E53 will 
contain the address of the last free byte at the end of RAM 
memory prior to the screen-required memory. 
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As a result of every OPEN command/ the following screen variables 
are altered: 

The text cursor is enabled (CRSINH = 0). The tabs are set to 
the default settings (2 and 39). The color registers are set 
to the default values (shown in Appendix H>. 

Tabs are set at positions 7/15/23,31,39/ 
47/ 55/63/ 71, 79/87/95/ 103/ 111/119. 



CLOSE 
No special handler actions. 

GET CHARACTERS and GET RECORD 

Returns data in the following screen mode dependent forms, where 
each byte contains the data for one cursor position (pixel); there 
is no facility for having the handler return packed graphics data. 



7 

4.-4.-4. -_4.-+-. 4. -.4. -.4.-4. 

I ATASCII I Mode 

4.-4.-^ — 4.-4.-4.-4. — ^.-4- 
4.-4.-4.-4. — ^.-4.-4,-4.-4. 

I C J D } Modes 1,2 — C = color/data 
4.-4.— 4.— 4. — ►—4.-4. — ^-4. set. 

D = truncated ATASCII. 

4.-4.-4.-4.-4.-4.-4.-4.-4. 

I zero I D I Modes 3/5/7 — D = color. 

4.-4.-4.-4.-4.-4.-4.-4.-4. 

4.-4—4.-4. — ^-4—4. — J.-4. 

} zero ID! Modes 4/6,8 — D = color. 

4.-4.-4.-4.-4.-4.-4.-4.-4. 

4. — ^ — ^.— 4. — ^ — ^ — J. — >.- 4. 

I zero I D I Modes 9,10,11 — D = data. 
4.-4.-4.-4.-4.-4.-4.-4.-4. 

Figure 5-6 Graphics Mode 3-11 GET Data Form 



The cursor moves to the next position as each data byte is 
returned. For mode O, the cursor will stay within the specified 
margins; for all other modes, the cursor ignores the margins. 
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PUT CHARACTERS and PUT RECORD 

The handler accepts display data in the following screen mode 
dependent forms; there is no facility for the handler to receive 
graphics data in packed form. 



7 O 

I ATASCII I Mode 

4— +-+-+-+--+-4— +-4" 

I C I D } Modes 1#2 — C = color/data 
4.-.4.-.+-.4.-.4.-.4.-+«+~+ set I 

D = truncated ATASCII. 

4— +~+— +-4—+-+— ♦•-+ 

I ? { D { Modes 3,5/7 — D = color. 

4—4— +~+— 4— 4— +-4— + 
4— 4— +-+—4- — h-4— 4— + 

5 ? \D\ Modes 4i 6, 8 — D = color. 

4— 4— 4-4- +—4—4- — h—+ 
4— +--+--4-4--4— 4— 4— 4- 

{ ? I D { Modes 9,10/11 — D = data. 



Figure 5-7 Graphics Mode 3-11 PUT Data Form 



NOTE: For all modes, if the output data byte equals *9B (EOL)/ that 
byte (liill be treated as an EOL character; and if the output 
data byte equals $7D (CLEAR) that byte uiill be treated as a 
screen-clear character. 

The cursor moves to the next cursor position as each data byte is 
written. For mode 0, the cursor will stay within the specified 
margins; for all other modes, the cursor ignores the margins. 

Mhile outputting/ the Display Handler monitors the keyboard to 
detect the pressing of the CCTRL3 1 key combination. When this 
occurs, the handler loops internally until that key combination 
is pressed again: This effects a stop/start function that 
freezes the screen display. Note that there is no ATASCII code 
associated with either the CCTRL3 1 key combination or the 
start/stop function. The stop/start function can be controlled 
only from the keyboard (or by altering database variable CH as 
discussed in Appendix L/ E4). 
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GET STATUS 
No handler action except to set the status to *01. 

DRAW 

This special command draws a simulated "straight" line from the 
current cursor position to the location specified in ROWCRS 
C00543 and COLCRS C00553. The color of the line is taken from the 
last character processed by the Display Handler or Screen Editor. 
To force the color, store the desired value in ATACHR i:02FB3. At 
the completion of the command, the cursor will be at the location 
specified by ROWCRS and COLCRS. 

The value for the command byte for DRAW is *11. 

FILL 

This special command fills an area of the screen defined by two 
lines with a specified color. The command is set up the same as 
in DRAW/ but as each point of the line is drawn, the routine 
scans to the right performing the procedure shown below (in 
PASCAL notation): 

WHILE PIXEL CROW, C0L3 = O DO 
BEGIN 

PIXEL CROW, C0L3 := FILDAT; 

COL : « COL •+• li 

IF COL > Screen right edge THEN COL := 
END; 

An example of a FILL operation is shown below: 



•*• 1 

+ 4. 

4. 4. 

4 4. 4. 

+ 2 

Where: '-' represents the fill operation. 

/+' are the line points, with '+' for the endpoints 



1 — set cursor and plot point. 

2 — set cursor and DRAW line. 

3 — set cursor and plot point. 

4 — set fill data value, set cursor, 



and FILL. 
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FILDAT C02FD3 contains the fill data, and ROWCRS and COLORS 
contain the cursor coordinates of the line endpoint. The value 
in ATACHR C02FB3 will be used to draw the line; ATACHR always 
contains the last data veadi or written/ so if the steps above 
are followed exactly/ ATACHR will not have to be modified. 

The value for the command byte for FILL is *12. 



User-Alterable Data Base Variables 

Certain functions of the Display Handler require you to 
examine and/or alter variables in the OS database. The following 
describes some of the more commonly used handler variables, (see 
Appendix L/ Bl-55/ for additional descriptions). 



Cursor Position 

Two variables maintain the cursor position for the graphics 
screen or mode text screen. ROWCRS C00543 maintains the display 
row number; and COLCRS C00553 maintains the display column 
number. Both numbers range from to the maximum number of 
rows/columns/ - 1. The cursor can be set outside of the defined 
text margins with no ill effect. You can read and write this 
region. The home position (0/0) for both text and graphics is the 
upper left corner of the screen. 

ROWCRS is a single byte. COLCRS is maintained at 2--bytes/ with 
the least significant byte being at the lower address. 

When you alter these variables/ the screen representation 
of the cursor will not move until the next I/O operation 
involving the display is performed. 

Inhibit/Enable Visible Cursor Display 

You can inhibit the display of the text cursor on the screen 
by setting the variable CRSINH C02F03 to any nonzero value. 
Subsequent I/O will not generate a visible cursor. 

You can enable the display of the text cursor by setting 
CRSINH to zero. Subsequent I/O will then generate a visible 
cursor. 



Text Margins 

The text screen has user-alterable left and right margins. The OS 
sets these margins to 2 and 39. The variable LMARGN C00523 
defines the left margin/ and the variable RMAR(?N C00533 defines 
the right margin. The leftmost margin value is O and the 
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rightmost margin value is 39. 

The margin values inclusively define the useable portion of the 

screen for all operations in that you do not explicitly 

alter the cursor location variables as described prior to this 

paragraph. 

Color Control 

The OS updates hardware color registers using data from the OS 
data base as part of normal Stage 2 VBLANK processing (see Section 
6). Shouin below are the data base variable namesi the hardware 
register names* and the function of each register. See Appendix H 
for the mode dependent uses for the registers. 



Data Base 


Harfiuiave 


Funct 


ion 




COLORO 


COLPFO 


PFO 


— 


Playfield 0. 




COLOR 1 


COLPFl 


PFl 


— 


Playfield 1. 




C0L0R2 


C0LPF2 


PF2 


— 


Playfield 2. 




COLORS 


C0LPF3 


PF3 


— 


Playfield 3. 




C0L0R4 


COLBK 


BAK 


— 


Playfield background 


PCOLRO 


COLPMO 


PMO 


— 


Player/missi le 


0. 


PCOLRl 


COLPMl 


PMl 


— 


Player/missi le 


1. 


PC0LR2 


C0LPM2 


PM2 


— 


Player/missi le 


2. 


PC0LR3 


C0LPM3 


PM3 


— 


Player/missi le 


3. 



Theory of Operation 

The Display Handler automatically sets up all memory resources 
required to create and maintain the screen display at OPEN time. 
The screen generation hardware requires that two distinct data 
areas exist for graphics modes: 1) a display list and 2) a 
screen data region. A third data area must exist for text modes. 
This data area defines the screen representation for each of the 
text characters. Consult the ATARI Home Computer 

Hardware Manual for a complete understanding of the material that 
is to follow. 
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The simplified block diagram beloui shows the relationships 
between the memory and hardware registers used to set up a screen 
display (without player /missile graphics) by the OS Note that 
the hardware registers allow for many other possibilities. 







DATA BASE 
VARIABLE 


-+ 

1 
1 

+ 

1 
1 

-+ 




HARDWARE 

REGISTER 

(Updated 

VBLANK > 


every 




1 MEMTOP 

« 

+ 4. 




* .*._..—>.«.-.. 








1 •r~— — —— -• 

1 1 
« 1 

! Display 
{ List 

ss 
1 


-4- 

1 

1 

t 
1 

s: 

1 
1 

1 

« 

1 
1 

!< 

ss 

1 
I 

i 
1 

1 

t 

-+ 


4. 

I SDLSTL 

1 SDLSTH 

• 

+ 


-+ 

1 

1 


< 






DLISTL } 

DLISTH 1 
1 


'•¥ 


1 

1 

1 
1 

-+ 


1 

1 

1 

i 


1 

1 

1 






i 

1 Screen Data 

ss 

1 Graphics 
1 and/or 
{ Text 


C— SAVMSC 

+ 

1 
1 


1 

1 

{ 

1 










d of RAM memory 






+- 

1 

1 

-+ 

i\ 
• 

-+ 

t 

1 
-+ 

-+ 




> J 






1 




CHBAS=EO 1- 


CHBA 


CC" -1.——— - 


I 




OC. .f~— — - 




,1, ,,„ 1 


EOOO 
ElOO 
E200 
E300 








i Specials an) 
' Numbers 




\ Capital 
1 Letters 




i Special 
1 Graphics 




1 Lowercase 

1 Letters 

+ 
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COLOR 





•f "1 

i 
1 


COLPFO 






s > 


COLPFl 


COLOR 


1 


t 
1 


C0LPF2 


COLOR 


2 


1 


C0LPF3 


COLOR 
COLOR 


3 
4 


1 

1 

1 J_ 


COLBK 


1 +• 

.JL. 



Figure 5-8 Screen Display Block Diagram 

The following relationships are present in the preceding diagram: 

1. Data base variables SDLSTL/SDLSTH contain the address of 
the current display list. This address is stored in the 
hardware display list address registers DLISTL and DLISTH 
as part of the VBLANK process. 

2. The display list itself defines the characteristics of the 
screen to be displayed and points to the memory containing 
the data to be displayed. 

3. Data base variable CHBAS contains the MSB of the base address 
of the character representations for the character data (text 
modes only). 

The default value for this variable is $E0. This variable 
declares that the character representations start at memory 
address EOOO (the character set provided by the OS in ROM). 
Each character is defined as an 8X8 bit matrix* requiring 8 
bytes per character. 1024 bytes are required to define the 
largest set/ since a character code contains up to 7 
significant bits (set of 128 characters). The OS ROM contains 
the default set in the region from EOOO to E3FF. 

All character codes are converted by the handler from ATASCII 
to an internal code (and vice versa)* as shown below: 



ATASCII 
CODE 



INTERNAL 
CODE 



00- IF 
20-3F 
40-5F 
60-7F 
80-9F 
AO-BF 
CO-DF 
EO-FF 



40- 5F 
00- IF 
20-3F 
60-7F 
CO-DF 
80-9F 
AO-BF 
EO-FF 
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The character set in ROM is ordered by internal code order. Three 
considerations differentiate the internal code from the external 
(ATASCm code: 

ATASCII codes for all but the special graphics characters were to 
be similar to ASCII. The alphabetic* numeric* and punctuation 
character codes are identical to ASCII. 

In text modes 1 and 2 it was desired that one character subset 
include capital letters* numbers* and punctuation and the other 
character subset include lowercase letters and special graphics 
characters. 

The codes for the capital and lowercase letters were to be 
identical in text modes 1 and 2. 

Database variables COLORO through C0L0R4 contain the current 
color register assignments. Hardware color registers receive 
these values as part of the stage 1 VBLANK process* thus 
providing synchronized color changes (see Appendix H). 

Database variable SAVMSC points to the lowest memory address of 
the screen data region. It corresponds to the data displayed at 
the upper left corner of the display. 

When the Display Handler receives an open command* it first 
determines the screen mode from the OPEN lOCB. Then it allocates 
memory from the end of RAH downward (as specified by data base 
variable RAMTOP)* first for the screen data and then for the 
display list. The screen data region is cleared and the display 
list is created if sufficient memory is available. The display 
list address is stored to the database. 
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Screen Editor (E: > 

The Screen Editor is a read/write handler that uses the Keyboard 
Handler and the Display Handler to provide " 1 ine-at-a-time" input 
with interactive editing functions* as well as formatted output. 

The Screen Editor supports the following CIO functions: 

OPEN 

CLOSE 

GET CHARACTERS 

GET RECORD 

PUT CHARACTERS 

PUT RECORD 

GET STATUS (null function) 



See Keyboard Handler and Display Handler Sections for a 
discussion of Screen Editor error statuses. 

The Screen Editor is one of the resident handlers* and 
therefore has a set of device vectors starting at location 
E400. 

The Screen Editor is a program that reads key data from the 
Keyboard Handler and sends each character to the Display Handler 
for immediate display. The Screen Editor also accepts data from 
you to send to the Display Handler* and reads data from the 
Display Handler (not the Keyboard Handler) for you. In fact* 
the Keyboard Handler* Display Handler, and the Screen Editor are 
all contained in one monolithic hunk of code. 

Most of the behaviors already defined for the Keyboard Handler 
and the Display Handler apply as well to the Screen Editor: The 
discussions in this Section will be limited to deviations from 
those behaviors* or to additional features that are part of the 
Screen Editor only. The Screen Editor deals only with text data 
(screen mode 0). This Section also explains the split-screen 
configuration feature. 

The Screen Editor uses the Display Handler to read data from 

graphics and text screens on demand. You use the Screen 

Editor to determine when the program will read Screen data* and 

where upon the screen the data will be read from. You 

first locates the cursor on the screen to determine the screen 

area to be read* you then press the CRETURN3 key to determine 

when the program will begin to read the data indicated. 
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When the CRETURN3 key is pressed, the entire logical line within 
that the cursor resides is then made available to the calling 
program: Trailing blanks in a logical line are never returned as 
data# however. After all of the data in the line has been sent to 
the caller (this can entail multiple READ CHARACTERS functions if 
desired >f an EOL character is returned and the cursor is 
positioned to the beginning of the logical line following the one 
just read. 



CIO Function Descriptions 

The device-specific characteristics of the standard CIO 
functions are detailed below: 



OPEN 

The device name is E/ and the Screen Editor ignores any 
device number and filename specification, if included. 

The Screen Editor supports the following option: 
7 

+--4—+— ♦•— ♦•- 4— +-+-+ 

AUXl { IWIRI IF! 

+—f— +—4— +—+—♦• — h — h 

Where: R and W are the direction bits (read and write). 

F = 1 indicates that a "forced reaii" is desired (see GET 
CHARACTER and GET RECORD for more information). 

CLOSE 
No special handler actions. 

GET CHARACTER and GET RECORD 

Normally the Screen Editor will return data only when you press the 
CRETURN3 key at the keyboard. However, the "forced read" OPEN option 
allows you to read text data without intervention. When you command a 
READ operation, the Screen Editor will return data from the start of 
the logical line in which the text cijrsor is located, and then 
move the cursor to the beginning of the following logical line. A 
read of the last logical line on the screen will cause the screen 
data to scroll. 

A special case occurs when characters are output without a 
terminating EOL, and then additional characters are appended to 
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that logical line from the keyboard. When the CRETURN3 key is 
pressed/ only the keyboard entered characters are sent to the 
caller/ unless the cursor has been moved out of and then back 
into the logical line/ in that case all of the logical line will 
be sent. 



PUT CHARACTER and PUT RECORD 

The Handler accepts ATASCII characters as one character per byte. 
Sixteen of the 256 ATASCII characters are control codesi the EOL 
code has universal meaning/ but most of the other control codes 
have special meaning only to a display or print device. The 
Screen Editor processing of the ATASCII control codes is 
explained below: 

CLEAR (♦yO) — The Screen Editor clears the current display of 
all data and the cursor is placed at the home position (upper 
left corner of the screen). 



(*1C) — The cursor moves up by one physical line. The 
cursor will wrap from the top line of the display to the bottom 



CURSOR UP 
curse 
1 ine. 



CURSOR DOWN (*1D) — The cursor moves down by one physical line. 
The cursor will wrap from the bottom line of the display to the 
top line. 



CURSOR LEFT (*1E) — The cursor moves left by one column. The 
cursor will wrap from the left margin of a line to the right 
margin of the same line. 



CURSOR RIGHT (*1F) — The cursor moves right by one column. The 
cursor will wrap from the right margin of a line to the left 
margin of the same line. 



BACKSPACE (*7E> — The cursor moves left by one column (but never 
past the beginning of a logical line)/ and the character at that 
new position is changed to a blank (*20). 
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SET TAB <*9F) — The Screen Editor establishes a tab point at the 
logical line position at that the cursor is residing. The logical 
line tab position is not synonymous with the physical line column 
position since the logical line can be up to 3 physical lines in 
length. For example* tabs can be set at the 15th/ 30th, 45th, 
60th and 75th character positions of a logical line as shown 
beloui: 



2 9 19 29 39 Screen column #. 

— L + + + R L/R = margins. 

XX T T A logical line. 

XX ^--T T T- X « inaccesible 

X X columns. 

Note the effect of the left margin in defining the limits of the 
logical line. 



The Handler default tab settings are shown below: 



O 2 
— L- 



9 



19 
.+ — 



29 
.4. — 



X xT~ 

X X 

X X — 



— T 

T 



■T- 
•T-- 
•T- 



J. 



T" 

T- 



39 Screen column #. 

-R L/R = margins. 

"T A logical line. 

•T X « inaccesible 
■T columns. 



CLEAR TAB (*9E> — The Screen Editor clears the current cursor 
position within the logical line from being a tab point. There is 
no "clear all tab points" facility provided by the Handler. 



TAB (*7F> — The cursor moves to the next tab point in the 
current logical line, or to the beginning of the next line if n 
tab point is found. This function will not increase the logical 
line length to accommodate a tab point outside the current leng 
(e.g. the logical line length is 38 characters and there is a t 



th 
ab 



point at position 50) 



INSERT LINE (*9D) — All physical lines at and below the physical 
line in that the cursor resides, are moved down by one physical 
line. The last logical line on the display can be truncated as a 
result. The blank physical line at the insert point becomes the 
beginning of a new logical line. A logical line can be split into 
two logical lines by this process, the last half of the original 
logical line being concatenated with the blank physical line 
formed at the insert point. 
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DELETE LINE (*9C) — The logical line in that the cursor resides 
is deleted and all data beloui that line is moved upward to fill 
the void. Empty logical lines are created at the bottom of the 
display. 

INSERT CHARACTER (^FF) — All physical characters at and behind 
the cursor position on a logical line are moved one position to 
the right. The character at the cursor position is set to blank. 
The last character of the logical line uiill be lost u;hen the 
logical line is full and a character is inserted. The number of 
physical lines comprising a logical line can increase as a result 
of this function. 

DELETE CHARACTER (*FE) — The character on which the cursor 
resides is removed/ and the remainder of the logical line to the 
right of the deleted character is moved to the left by one 
position. The number of physical lines composing a logical line 
can decrease as a result of this function. 

ESCAPE (*1B) — The next non-EOL character following this code is 
displayed as data« even if it would normally be treated as a 
control code. The sequence CESC3CESC3 will cause the second CESC3 
character to be displayed. 

BELL i^FD) — An audible tone is generated; the display is not 
modified. 

END OF LINE (*9B) ~~ In addition to its record termination 
function* the EOL causes the cursor to advance to the beginning 
of the next logical line. When the cursor reaches the bottom line 
of the screen* the receipt of an EOL will cause the screen data 
to scroll upward by one logical line. 



GET STATUS 
The Handler takes no action other than to set the status to $01 



User-Alterable Data Base Variables 

Also see the Display Handler data base variable discussion. 
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Cursor Position 

When in a split-screen configuration! ROWCRS and COLCRS are associated 
with the graphics portion of the display and two other variablesi 
TXTROW C02903 and TXTCOL C02913* are associated with the text window. 
TXTROW is a single byte* and TXTCOL is 2-bytes with the least 
significant byte being at the lower address. Note that the most 
significant byte of TXTCOL should always foe zero. 

The home position (0,0) for the text window is the upper left corner 
of the window. 



Enable/Inhibit of Control Codes in Text 

Normally all text mode control codes are operated upon as received/ 
but sometimes it is desirable to have the control codes displayed as 
if they were data characters. This is done by setting the variable 
DSPFLO C02FE3 to any nonzero value before outputting the data 
containing control codes. Setting DSPFLO to zero restores normal 
processing of text control codes. 
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Cassette Handler <C: > 

The Cassette device is a read or write device with a Handler 
that supports the following CIO functions: 



OPEN 

CLOSE 

GET CHARACTERS 

GET RECORD 

PUT CHARACTERS 

PUT RECORD 

GET STATUS (null function) 



The Cassette Handler can produce the following error statuses: 

*80 — CBREAK3 key abort. 

*84 — Invalid AUXl byte on OPEN. 

*88 — end~of~f ile. 

*8A-90 — SIO error set (see Appendix C>. 

The Cassette Handler is one of the resident handlers/ and therefore 
has a set of device vectors starting at location E440. 



CIO Function Descriptions 

The device-specific characteristics of the standard CIO functions are 
detailed below: 



OPEN 

The device name is C/ and the Handler ignores any device number and 
filename specification/ if included. 

The Handler supports the following option: 
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7 O 

AUX2 iC! i 

+-+--+-4— +--+-+—♦— + 

Where: C = 1 indicates that the cassette is to be read/written without 
stop/start between records (continuous mode). 

Opening the cassette for input generates a single audible tone^ as a 

prompt for you to verify that the cassette player is set up 

for reading (power on; Serial Bus cable connected* tape cued to start 

of file; and PLAY button depressed). When the cassette is ready* 

you can press any keyboard key (except CBREAK}) to initiate tape 

reading. 

Opening the cassette for output generates two closely spaced audible 
tones* as a prompt for you to verify that the cassette player 
is set up for writing (as above* plus RECORD button depressed). When 
the cassette is ready* you can press any keyboard key (except 
CBREAK3) to begin tape writing. There is no way for the computer to 
verify that the RECORD or PLAY button is depressed. It is possible for 
the file not to be written, with no immediate indication of this fact. 

There is a potential problem with the cassette in that when the 
cassette is opened for writing* the motor keeps running until the 
first record (128 data bytes) is written. If 128 data bytes are 
written or the cassette is closed within about 30 seconds of the OPEN* 
and no other serial bus I/O is performed* then there is no problem. 
However* if those conditions are not met* some noise will be written 
to the tape prior to the first record and an error will occur when 
that tape file is read later. If lengthy delays are anticipated 
between the time the cassette file is opened and the time that the 
first cassette record (128 data bytes) is written* then a dummy record 
should be written as part of the file; typically 128 bytes of some 
innocuous data would be written* such as all zeros* all $FFs* or all 
blanks (!^20). 

The system sometimes emits whistling noises after cassette I/O has 
occurred. The sound can be eliminated by storing *03 to SKCTL CD20F3* 
thus bring POKEY out of the two-tone (FSK) mode. 

CLOSE 

The CLOSE of a tape read stops the cassette motor. 

The CLOSE of a tape write does the following: 

Writes any remaining user data in the buffer to tape. 
Writes an end-of-file record. 
Stops the cassette motor. 
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GET CHARACTERS and GET RECORD 
The Handler returns data in the following format: 

7 

i data byte • 

4.-.4.-4.— +_4.-.4._4.-.+».4. 

PUT CHARACTERS and PUT RECORD 
The Handler accepts data in the following format: 

7 O 

+-4— 4— +—♦—+-+--+-+ 

• data byte I 
•♦—+-+--+•- 4— •< — +—4— 4- 

The Handler attaches no significance to the data bytes 
written* a value of *9B (EOL) causes no special action. 

GET STATUS 
The Handler does no more than set the status to $01. 



Theory of Operation 

The Cassette Handler writes and reads all data in fixed-length records 
of the format shown below: 



+-4. -4.-4.-4.-4. -.4. -4. ». 4. 

10 1 1 1 If Speed measurement bytes. 
4.-4.-4.-4.-4.-4.-4.-4.-4. 

1 1 1 1 1 { 
4.— 4.-4.— 4.-4.-4.— 4, — ^.-4. 

! control byte I 
4.-4.-4.— 4.-4.-4,-4.— 4.-4. 

I 128 I 

= data = 

! bytes ! 
4.-4.— 4.— 4.-4.-4.— 4.— 4.— 4. 

I checksum J (Managed by SIO/ not the 
4.-4.-4.-4.-4.-4.-4.-4.-4. Handler. ) 

Figure 5-9 Cassette Handler Record Format 
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The control byte contains one of three values: 

*FC indicates the record is a full data record (128 bytes). 

o *FA indicates the record is a partially full data record; you 
supplied fewer than 128 bytes to the record. This case can 
occur only in the record prior to the end~of-file. The number 
of user-supplied data bytes in the record is contained in the 
byte prior to the checksum. 

o ♦FE indicates the record is an End-of file record; the data 
portion is all zeroes for an end-of-f i le record. 

The SIO routine generates and checks the checksum. It is part of the 
tape record* but it is not contained in the Handler's record buffer 
CASBUF C03FD3. 

The processing of the speed-measurement bytes during cassette reading 
is discussed in Appendix L/ D1-D7. 

File Structure 

The Cassette Handler writes a file to the cassette device with a file 
structure that is totally imposed by the Handler (soft format). A file 
consists of the following three elements: 

o A 20-second leader of mark tone. 

o Any number of data-record frames. 

o An end-of-file frame. 

The cassette-data record frames are formatted as shown below: 

frame = pre-record write tone (PRWT)i 
•♦• data record/ 
+ post record gap (PRO) 

The nondata portions of a frame have characteristics that are 
dependent upon the write OPEN mode« i. e. continuous or 
start/stop. 

Stop/start PRWT = 3 seconds of mark tone. 
Continuous PRWT » .25 second of mark tone. 

Stop/start PRO = up to 1 second of unknown tones. 
Continuous PRO = from to n seconds of unknown tones» where 

n is dependent upon your program timing. 

The inter-record gap (IRG) between any two records consists of 
the PRO of the first record followed by the PRWT of the second 
record. 
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Printer Handler <P: > 

The Printer device is a write-only device with a Handler that 
supports the following CIO functions: 

OPEN 

CLOSE 

PUT CHARACTERS 

PUT RECORD 

GET STATUS 

The Printer Handler can produce the following error statuses: 

*8A-90 — SIO error set (see Appendix C). 

The Printer Handler is one of the resident handlersi and 
therefore has a set of device vectors starting at location E430. 



CIO Function Descriptions 

The device-specific characteristics of the standard CIO functions 
are detailed below: 



OPEN 

The device name is P. The Handler ignores any device number and 
filename specification* if included. 



CLOSE 

The Handler writes any data remaining in its buffer to the 
printer device* with trailing blanks to fill out the line. 



PUT CHARACTERS and PUT RECORD 
The Handler accepts print data in the following format: 

7 

4. — >.-4.— 4.-.+-.4. — y.^+^ + 

ATASCII I 
+ — h--4—+— +•— ♦—+—♦— + 

The only ATASCII control code of any significance to the Handler 
is the EOL character. The printer device ignores bit 7 of every 
data byte and prints a sub set of the remaining 128 codes, (see 
Appendix G for the printer character set). 

The Handler supports the following print option: 
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AUX2 



7 

1 print mode ' 



Where: *4E (N> selects normal printing (40 characters per line). 
*53 (S) selects sideways printing (29 characters per line) 
*57 (W) selects wide printing (not supported by printer 
device). 

Any other value (including 00) is treated as a normal (N) 
print select/ without producing an error status. 



GET STATUS 

The Handler obtains a 4-byte status from the printer 
controller and puts it in system location DVSTAT C02EA3. The 
format of the status bytes is shown below: 



i command stat. ! 

I AUX2 of prev. I 
+-+—• ♦— 4-- f--+~+-+— +• 

i timeout • 
! (unused ) • 



DVSTAT 4- O 

+ 1 

+ 2 

+ 3 



The command status contains the following status bits and 
condition indications: 



bit 
bit 1 
bit 7 



an invalid command frame was received. 

an invalid data frame was received. 

an intelligent controller (normally = 0) 



The next byte contains the AUX2 value from the previous operation, 

The timeout byte contains a controller provided maximum timeout 
value (in seconds). 



Theory of Operation 

The ATARI 820CTM3 40--Column Printer is a 1 ine~at~a-time printer rather 
than a character-at-a-time printer/ so your data must be buffered by 
the Handler and sent to the device in records corresponding to one 
print line (40 characters for normal/ 29 characters for sideways). 
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The printer device does not attach any significance to the EOL 
character/ so the Handler does the appropriate blank fill 
whenever it sees an EOL. 



Disk File Manager (D: ) 

The OS supports four unique File Management Subsystems at the 
time of this writing. Version lA is the original version. 
Version IB is a slightly modified version of lA and is the one 
described in this document. Most of this discussion applies as 
well to Version lit that handles a double-density diskette <720 
256-byte sectors) in addition to the single-density diskette (720 
128-byte sectors). Version III has all new file/directory/map 
structures and can possibly contain changes to your interface 
as well. 

The File Management Subsystem includes a disk-bootable 
(RAM-resident) Disk File Manager (DFM) that maintains a 
collection of named files on diskettes. Up to 4 disk drives 
(Dl: through D4: ) can be accessed/ and up to 64 files per 
diskette can be accessed. The system diskettes supplied by ATARI 
allow a single disk drive (Dl) and up to 3 OPEN files, but 
you can alter these numbers as described later in 
this section. 



The Disk File Manager supports the following CIO functions 

OPEN FILE 
OPEN DIRECTORY 
CLOSE 

GET CHARACTERS 
GET RECORD 
PUT CHARACTERS 
PUT RECORD 
GET STATUS 



NOTE 

POINT 

LOCK 

UNLOCK 

DELETE 

RENAME 

FORMAT 
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The Disk File Manager can produce the -following error statuses 

$03 — Last data from file (EOF on next read). 

♦88 — end~of-file. 

*8A-90 — SIO error set (see Appendix C). 

*A0 — Drive number specification error. 

*Ai — No sector buffer available (too many open files). 

*A2 -— Disk full. 

*A3 — Fatal I/O error in directory or bitmap. 

$A4 — Internal file # mismatch (structural problem). 

*A5 — File name specification error. 

»A6 — Point information in error. 

*A7 — File locked to this operation. 

*A8 — Special command invalid. 

*A9 — Directory full (64 files). 

♦AA — File not found. 

$AB — Point invalid (file not OPENed for update). 



CIO Function Descriptions 

The device-specific characteristics of the standard CIO functions 
are detailed below: 



OPEN FILE 

The device name is D. Up to four disk drives can be accessed (Dl 
through D4). The disk filename can be from 1 to 8 characters in 
length with an optional 1- to S-character extension. 

The OPEN FILE command supports the following options: 



7 

4.-.4.-.4....+.-.4.«.+«.4.-.4.-.+ 

AUXi i iUiIRi iAi 

+-4.-.+...4.-.4.-.4.«.4.-4.— + 

Where: W and R are the direction bits. 
WR =00 is invalid 

01 indicates OPEN for re&d only. 

10 indicates OPEN for write only, 

11 indicates OPEN for read/write (update) 



A = 1 indicates appended output when W = 1. 
You may use these following valid AUXI options: 
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OPEN Input (AUXl = *04) 

The indicated file is opened for input. Any wild-card characters 
are used to search for the first match. If the file is not found, 
an error status is returned, and no file will be opened. 



OPEN Output (AUXi = *08) 

The indicated file is opened for output starting with the first 
byte of the file, if the file is not locked. Any wild-card 
characters are used to search for the first match. If the file 
already exists, the existing file will be deleted before opening 
the named file as a new file. If the file does not already exist, 
it will be created. 

A file opened for output will not appear in the directory until 
it has been closed. If an output file is not properly closed, 
some or all of the sectors that were acquired for it can be lost 
until the disk is reformatted. 

A file that is opened for output can not be opened concurrently 
for any other access. 



OPEN Append <AUX1 = *09) 

The indicated file is opened for output starting with the byte 
after the last byte of the existing file (that must already 
exist), if the file is not locked. Any wild-card characters are 
used to search for the first match. 

If a file opened for append is not properly closed, the appended 
data will be lost. The existing file will remain unmodified and 
some or all of the sectors that were acquired for the appended 
portion can be lost until the diskette is reformatted. 



OPEN Update (AUXl = *0C ) 

The indicated file (that must already exist) will be opened for 
update provided it is not locked. Any wild-card characters are 
used to search for the first match. 

The GET, PUT, NOTE and POINT operations are all valid, and can be 
intermixed as desired. 

If a file opened for update is not properly closed, a sector's 
worth of information can be lost to the file. A file opened for 
update can not be extended. 
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Device/Filename Specification 

The Handler expects to find a device/filename specification of 
the following form: 



DC<nu(nber>3: <:f ilename><:EOL> 
where: 

<number> : : = 1I25314 

<filename> ::= C<primary>lC. C<extension>33<terminator> 
<primary> : : = an uppercase alpha character followed by to 7 
alphanumeric characters. If the primary name is 
less than 8 characters* it will be padded with 
blanks; if it is greater than 8 characters/ the 
extra characters will be ignored. 

<extension> : : = Zero to 3 alphanumeric characters. If the 
extension name is missing or less than 3 
characters/ it will be paddeti with blanks; if 
it is greater than 3 characters/ the extra 
characters will be ignored. 

<terminator> ::= <EOL>{<blank> 
Figure 5-10 Device/Filename Syntax 



The following are all valid device/filenames for the diskette 

Dl: GAME. SRC 

D: MANUAL6 

D: . WHY 

D3:FILE. 

D4: BRIDGE. 002 



Filename Wildcarding 

The filename specification can be further generalized to include 
the use of the "wild-card" characters * and ?. These wildcard 
characters allow portions of the primary and/or extension to be 
abbreviated as follows: 

The ? character in the specification allows any filename 
character at that position to produce a "match. " For example/ WH? 
will match files named WHO/ WHY/ WH4/ etc./ but not a file named 
WHAT. 
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The * character causes the remainder of the primary or extension 
field in that it is used to be effectively padded with ? 
characters. For example/ WH* will match WHO. WHEN, WHATEVER, etc. 

Some valid uses of wild-card specifications are shown below: 

*. SRC Files having an extension of SRC. 

BASIC* Files named BASIC with any extension. 

*. * All files. 

H*. ? Files beginning with H and having a or 1 

character extension. 

If wildcarding is used with an OPEN FILE commandi the first file 
found (if any) that meets the specification will be the one (and 
only one) opened. 

OPEN DIRECTORY 

The OPEN DIRECTORY command allows you read directory 
information for the selected filename(s)i using normal GET 
CHARACTERS or GET RECORD commands. The information read will be 
formatted as ATASCII records* suitable for printing, as shown 
below. Wildcarding can be used to obtain information for multiple 
files or the entire diskette. 

The OPEN DIRECTORY command uses the same CIO parameters as a standard 
OPEN FILE command: 

COMMAND BYTE = *03 

BUFFER ADDRESS = pointer to device/filename specification. 

AUXl = *06 

After the directory is opened, a record will be returned to the 
caller for each file that matches the OPEN specification. The 
record/ that contains only ATASCII characters, is formatted as 
shown below: 



1 
123456789012345678 

Is lb I primary name I ext Jb 'count 'el 
+— ♦• — »— 4.-4.— ^—4.~+~4—+-- 4- —♦—+-•+-- 4- --4— ■ + -+-- 4- 
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Uhere: s = » or ' '# with * indicating file locked, 
b s blank. 

primary name = left-justified name with blank fill, 
ext = left-justified extension with blank fill, 
b = blank. 

count = number of sectors comprising the file, 
e = EOL (*9B). 

After the last filename match record is returned/ an additional 
record is returned. This record indicates the number of unused 
sectors available on the diskette. The format for this record is shown 
below: 

1 
12345678901234567 

+— ♦•- +-4—4— +-• f — h-4.~+-4— 4— 4—4— 4— 4— 4— 4- 

IcountJ FREE SECTOR Slel 

4— 4— 4— 4— 4— 4—4— -4— -+~4— 4— +--4— 4— 4— 4—4— 4- 

Where: count = the number of unused sectors on the diskette. 
e = EOL (*9B). 

The EOF statuses (*03 and *88) are returned as in a normal data 
file when the last directory record is read. 

The opening of another diskette file while the directory read is 
open will cause subsequent directory reads to malfunction/ so 
care must be taken to avoid this situation. 

CLOSE 

Upon closing a file read* the Handler releases all internal 
resources being used to support that file. 

Upon closing a file write/ the Handler: 

o writes any residual data from its file buffer for that file 
to the diskette. 

o updates the directory and allocation map for the associated 
diskette. 

o releases all internal resources being utilized to support 
that file 



GET CHARACTERS and GET RECORD 

Characters are read from the diskette and passed to CIO as a raw 
data stream. None of the ATASCII control characters have any 
special significance. A status of $88 is returned if an attempt 
is made to read past the last byte of a file. 
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PUT CHARACTERS and PUT RECORD 

Characters sre obtained from CIO and written to the diskette as a raw 
data stream. None of the ATASCII control characters have any special 
significance. 

GET STATUS 

The indicated file is checked and one of the following status 
byte values is returned in ICSTA and register Y: 

*01 — File found and unlocked. 
*A7 — File locked. 
*AA — File not found. 



Special CIO Functions 

The DFM supports a number of SPECIAL commands# that are device 
specific. These are explained in the paragraphs that follow: 

NOTE (COMMAND BYTE = $25) 

This command returns to the caller the exact diskette location of 
the next byte to be read or written* in the variables shown 
below: 

ICAX3 = LSB of the diskette sector number. 
ICAX4 = MSB of the diskette sector number. 
ICAX5 = relative sector displacement to byte (0-124). 

POINT (COMMAND BYTE = *26) 

This command allows you to specify the exact diskette location of 
the next byte to be read or written. In order to use this commmandi 
the file must have been opened with the "update" option. 

ICAX3 = LSB of tbe diskette sector number. 
ICAX4 « MSB of the diskette sector number. 
ICAX5 = relative sector displacement to byte (0-124). 
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LOCK 

This command allows you to prevent uirite access to any 
number of named files. Locked files can not be deleted, renamed; 
nor opened for output unless they are first unlocked. Locking a 
file that is already locked is a valid operation. The Handler 
expects a device/filename specification; then all occurrences of 
the filename specified will be locked, using the wild-card rules. 

You set up these following lOCB parameters prior to 
calling CIO: 

COMMAND BYTE = ^23 

BUFFER ADDRESS = pointer to device/filename specification. 

After a LOCK operation, the following IOCS parameter will have 
been altered: 

STATUS = result of LOCK operation; see Appendix B for a list 
of possible status codes. 

UNLOCK 

This command allows you to remove the lock status of any 
number of named files. Unlocking a file that is not locked is a 
valid operation. The Handler expects a device/filename 
specification; then all occurrences of the filename specified 
will be unlocked, using the wild-card rules. 

You set up these following lOCB parameters prior to 
calling CIO: 

COMMAND BYTE = *24 

BUFFER ADDRESS = pointer to device/filename specification. 

After an UNLOCK operation, the following lOCB parameter will have been 
altered: 

STATUS = result of UNLOCK operation; see Appendix B for a 
list of possible status codes. 



DELETE 

This command allows you to delete any number of unlocked 
named files from the directory of the selected diskette and to 
deallocate the diskette space used by the files involved. The 
Handler expects a device/filename specification; then all 
occurences of the filename specified will be deleted, using the 
wild-card rules. 
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You set up these following lOCB parameters prior to 
calling CIO: 

COMMAND BYTE = *21 

BUFFER ADDRESS = pointer to device/filename specification. 

After a DELETE operation^ the following lOCB parameter will have 
been altered: 

STATUS = result of DELETE operation; see Appendix B for a list of 
possible status codes. 



RENAME 

This command allows you to change the filenames of any 
number of unlocked files on a single diskette. The Handler 
expects to find a device/filename specification that follows: 

<device spec>: <f ilename spec>/ <f i lename spec>CEOL> 

All occurrences of the first filename will be replaced with the 
second filename/ using the wild-card rules. No protection is 
provided against forming duplicate names. Once formed* duplicate 
names cannot be separately renamed or deleted; however* an OPEN 
FILE command will always select the first file found that matches 
the filename specification* so that file will always be 
accessible. The RENAME command does not alter the content of the 
files involved* merely the name in the directory. 

Examples of some valid RENAME name specifications are shown 
below: 

Dl: *. SRC, *. TXT 
D: TEMP* FD AT A 
D2: F*, F*. OLD 

You set up these following lOCB parameters prior to 
calling CIO: 

COMMAND BYTE = *20 

BUFFER ADDRESS ~ pointer to device/filename specification. 

After a RENAME operation* the following lOCB parameter will have 
been altered: 

STATUS = result of RENAME operation* see Appendix B for a 
list of possible status codes. 
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FORMAT 

Soft-sector diskettes must be formatted before they can store 
data. The FORMAT command allows you to physically format a 
diskette. The physical formatting process writes a new copy of 
every sector on the soft-sectored diskettei with the data portion 
of each sector containing all zeros. The FORMAT process creates 
an "empty" non system diskette. When the formatting process is 
complete/ the FMS creates an initial Volume Table of Contents 
(VTOO and an initial File Directory. The boot sector (#1) is 
permanently reserved as part of this process. 

You set up these following lOCB parameters prior to 
calling CIO: 

COMMAND BYTE = *FE 

BUFFER ADDRESS = pointer to device specification. 

After a FORMAT operation^ the following lOCB parameter will have 
been altered: 

STATUS = result of FORMAT operation; see Appendix B for a 
list of possible status codes. 

To create a system diskette* a copy of the boot file must then be 
written to sectors #2-n. This is accomplished by writing the file 
named DOS. SYS. This is a name that is recognized by the FMS even 
though it is not in the directory initially. 



Theory of Operation 

The resident OS initiates the disk-boot process (see Section 10). 
The OS reads diskette sector #1 to memory and then transfers 
control to the "boot continuation address" (boot address + 6). 
The boot-continuation program contained in sector #1 then 
continues to load the remainder of the File Management Subsystem 
to memory using additional information contained in sector #1. 
The File Management Subsystem loaded* will contain a Disk File 
Manager /and optionally* a Disk Utilities (DOS) package. 

When the boot process is complete* the Disk File Manager will 
allocate additional RAM for the creation of sector buffers. 
Sector buffers are allocated based upon information in the boot 
record as shown below: 

Byte 9 = maximum number of open files* one buffer per (the 
maximum value is 8). 

Byte 10 = drive select bits* one buffer per (1-4 only). 
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The Disk File Manager will then insert the name D and the Handler 
vector table address in the device table. 

NOTE: There is a discrepancy between the Disk File Manager's 
numbering of diskette sectors (0-719) and the disk controller's 
numbering of diskette sectors <i-720); as a result/ only sectors 
1- 719 are used by the Disk File Manager. 

The Disk File Manager uses the Disk Handler to perform all 
diskette reads and writes; the DFM's function is to support and 
maintain the directory/file/bitmap structures as described in the 
following pages: 
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FMS Diskette Utilization 

The map below shows the diskette sector utilization for a 
standard 720 sector diskette. 



4- + 

I BOOT record { Sector 1 

+ + 

I FMS BOOT I Sector 2 -•+ 
file = I 

{ DOS. SYS •• Sector n +-- Note 1 

4. + I 

I User I Sector n+1 -+ 

File 
I Area I Sector 359 (*167) 

+ + 

{ VTOC(note 2> I Sector 360 (*168) 

+ + 

I File I Sector 361 (*169> 
= Directory = 

{ { Sector 368 (*170) 

4. 4. 

{ User } 
File 

I Area I Sector 719 <*2CF) 

4. + 

I unused { Sector 720 (*2D0> 

4. 4. 

Figure 5~11 File Management Subsystem Diskette Sector Utilization 
Map 

NOTE i - If the diskette is not a system diskette^ then your 
File Area starts at sector 2 and no space is reserved for the FMS 
BOOT file. However/ "DOS" (DOS. SYS and DUP. SYS) may still be 
written to a diskette that has already used sectors "2--N. " 

NOTE 2 — VTOC stands for Volume Table of Contents. 



OPERATING SYSTEM C016555 — Section 5 



89 



FMS Boot Record Format 

The FMS BOOT record (sector #1) is a special case of diskette-booted 
software (see Section 10). The format for the FMS BOOT record is 
shouin belou;: 



4. 4. 

boot flag = 



# sectors 



boot address 
= 0700 






init address 



JMP = *4B 

boot read 
continuation 
address 



max files = 3 



drive bits 



alloc dire = 



boot image end 
address -»- 1 



boot flag <> O 



sector count 



DOS. SYS 
starting 
sector number 



code for second 
phase of boot 



Byte 
1 

2 



9 Note 1 

10 Note 2 

11 Note 3 



FMS 

configuration 

data 



14 Note 4 

15 Note 5 



Figure 5-12 File Management Subsystem Boot Record Format 



OPERATING SYSTEM C016555 — Section 5 



90 



NOTE 1 - Byte 9 specifies the maximum number of concurrently open 
files to be supported. This value can range from 1 to 8. 

NOTE 2 - Byte 10 specifies the specific disk drive numbers to be 
supported using a bit encoding scheme as shouin below: 

7 6 5 4 3 2 10 
+-4. -.4.-.+-. 4—+.-. .#.-.4. — i. 

\ !4!3!2il! where a 1 indicates a selected drive. 

4.-4.-4. -.4. -.4.-4. ...4. ...4. -.4. 

NOTE 3 - Byte 11 specifies the buffer allocation direction^ this 
byte should equal 0. 

NOTE 4 - Byte 14 must be nonzero for the second phase of the boot 
process to initiate. This flag indicates that the file 
DOS. SYS has been written to the diskette. 

NOTE 5 - This byte is assigned as being the sector count for the 
DOS. SYS file. It is actually an unused byte. 
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Boot Process Memory Map 



The diagram beloui shows how the boot sector (part of file 

DOS. SYS) and following sectors are loaded to memory as part of 

the boot process. 



+ + 

! data from boot ! 
= sector read by = 
I resident OS • 

+ + 

} data from rest I 
{ of DOS. SYS I 
I read by the ! 
= program in the « 
I boot sector. I 



Memory address 0700 

I 

I 
077G 

077D 



end of boot 



Figure 5-13 File Management Subsystem Boot Process Memory Map 
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Volume Table of Contents 

The format for the FMS volume table of contents (VTOC/ sector 
360> is shown in the diagram foelou): 

+ ^ 

{ directory type { Byte Note 1 

4. ^ 

! maximum do) I 1 Note 2 

+ sector # + 

{ = 02C5 (hi) { 

+ ^ 

\ number of do) 1 3 Note 3 

+ sectors •♦• 

! available (hi) i 

^ ^ 



+ ^ 

{ I 10 

= volume bit map = 

+ 4. 



+ 4. 

Figure 5-14 File Management Subsystem Volume Table of Contents 
The volume bit map organization location follows: 



7 

4._4.-.4._4.«.4.-.+_4.-.4.-+ 

{12 3 4 5 6 7! Byte 10 of VTOC 



I I 



18 9 I 11 



99 



•+• — h — h — »—•+—+ >■ — h — h 

Figure 5-15 File Management Subsystem Volume Bit Map 

At each map bit position* a indicates the corresponding sector 
is in use and a 1 indicates that the sector is available. 

NOTE 1 - The directory type byte must eq.ual 0. 

NOTE 2 -■ The maximum sector number is not used because it is 

incorrectly set to 709 decimal. The true maximum sector 
number is actually 719 for the DFM. 
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NOTE 3 ~ The number of sectors available is initially set to 709 
after a diskette is freshly formatted; this number is 
adjusted as files are created and deleted to shou the 
number of sectors available. The sectors that are 
initially reserved are i and 360-368. 



File Directory Format 

The FMS reserves eight sectors (361-368) for a file directory. 
Each sector containing directory information for up to eight 
files/ thus providing for a maximum of 64 files for any volume, 
The format of a single 16-byte file entry is shown below: 



+ 



--+ 



+ 



sector (lo) 
+ count 

(hi) 



•f 



starting (lo) 
+ sector 

number (hi) 



flag byte 



+ 



+ 





(1) 




(2) 




(3) 


file 


(4) 


name 


(5) 


primary 


(6) 




(7) 




(8) 


file 


(1) 


name 


(2) 


extension 


(3) 



Byte 
1 



13 



Figure 5-16 File Directory Format 



Where the flag byte has the following bits assigned: 
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bit 7 « 1 if the file has been deleted, 

bit 6 = 1 if the file is in use. 

bit 5 = 1 if the file is locked, 

bit = 1 if OPEN output. 

The flag byte can take on the following values: 

$00 = entry not yet used <no file). 

*40 = entry in use (normal CLOSEd file). 

♦41 =s entry in use (OPEN output file). 

*60 = entry in use (locked file). 

*80 = entry available (prior file deleted). 

Sector count is the number of sectors comprising the file. 



FMS File Sector Format 
The format of a sector in your data file is shown below: 

7 

+•— *--4-- ♦— +-4— 4-- ♦— •+ 

I data I +0 



{ file # {hi I +125 

4._4.-+_4..».4.-+_4. + 

{forward pointer { +126 

+--+~+~+-+--+~+~+--+ 

{S{ byte count { +127 

Figure 5-17 File Management Subsystem File Sector Format 

The FMS uses the file # to verify file integrity. The file # 
is a redundant piece of information. The file number field 
contains the value of the directory position of that file. If a 
mismatch occurs between the file's directory position/ and the 
file number as contained in each sectori then the DFM will 
generate the error *A4. 

The forward pointer field contains the 10-bit value for the 
diskette sector number of the next sector of the file. The 
pointer equals zero for the last sector of a file. 

The S bit indicates whether or not the sector is a "short sector" 
(a sector containing fewer than 125 data bytes). S is equal to 
1 when the sector is short. 
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The byte-count field contains the number of data bytes in the 
sector. 



Non-CIO I/O 

Some portions of the I/O subsystem are accessed independently of 
the Central I/O Utility (CIO); this section discusses those 
areas. 



Resident Device Handler Vectors 

All of the OS ROM resident device handlers can be accessed via 
sets of vectors that are part of the OS ROM. These vectors 
increase the speed of I/O operations that utilize fixed device 
assignments/ such as output to the Display Handler. For each 
resident Handler there is a set of vectors ordered as shown 
below: 



+ 4. 

-»"- OPEN -+ +0 

+ 4. 

+- CLOSE -+ +2 

+ + 

+-- GET BYTE —*■ +4 

+ 4. 

+- PUT BYTE ~+ -H6 

4. 4. 

■*"- GET STATUS -+ +8 

4. 4. 

+~ SPECIAL -+ +10 

4. 4. 

+~ JMP — ♦- +12 

+- INIT -+ 

4. 4. 

+- SPARE ~+ 
4.- BYTE ~+ 

4. 4- 



Figure 5-18 Resident Device Handler Vectors 



See Section 9 for a detailed description of the data interface 
for each of these Handler entry points. 

Each of the vectors contains the address (lo/hi) of the Handler 
entry point minus 1. A technique similar to the one shown beloui 
is required to access the desired routines: 
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VTBASE=$E400 



; BASE OF VECTOR TABLE. 



LDX #xx 
LDA data 
JSR OOVEC 



LDX 


#yy 


JSR 


OOVEC 


STA 


data 


GOVEC TAY 




LDA 


VTBASE-*-!, X 


PHA 




LDA 


VTBASE, X 


PHA 




TYA 




RTS 





OFFSET TO DESIRED ROUTINE. 

SEND DATA TO ROUTINE. 

OFFSET TO DIFFERENT ROUTINE. 
GET DATA FROM ROUTINE. 



SAVE REGISTER A. 
ADDRESS MSB TO STACK. 

ADDRESS LSB TO STACK. 

RESTORE REGISTER A. 
JUMP TO ROUTINE. 



The JMP INIT slot in each set of vectors jumps to the Handler 
initialization entry (not minus 1). 

The base address of the vector set for each of the resident 
handlers is shouin beloui: 



Screen Editor (E: ) E400. 

Display Handler (S: > E410. 

Keyboard Handler (K: ) E420. 

Printer Handler (P: ) E430. 

Cassette Handler (C: ) E440. 

The resident diskette Handler is not ClO-compatiblei so its 
interface does not use a vector set. 



Resident Diskette Handler 



The resident Diskette Handler (not to be confused with the Disk 
File Manager) is responsible for all physical accesses to the 
diskette. The unit of data transfer for this Handler is a single 
diskette sector containing 128 data bytes. 

Communication betu/een you and the Diskette Handler is 
effected using the system's Device Control Block (DCB)/ that is 
also used for Handler/SIO communication (see Section 9). The DCB 
is 12 bytes long. Some bytes are user-alterable and some are for 
use by the Diskette Handler and/or the Serial I/O Utility (SIO). 
You supply the required DCB parameters and then do a JSR 
DSKINV CE4533. 
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Each of the DCB bytes will now be described/ and the 
system-equate file name for each will be given. 

SERIAL BUS ID — DDEVIC C03003 

The Diskette Handler sets up this byte to contain the Serial Bus ID 
for the drive to be accessed. It is not user-alterable. 



DEVICE NUMBER — DUN IT C 030 13 

You set up this byte to contain the disk drive number to be 
accessed (1 - 4). 



COMMAND BYTE — DCOMND C 0302 3 

You set up this byte to contain the disk device command to 
be performed. 



STATUS BYTE — DSTATS C 0303 3 

This byte contains the status of the command upon return to the 
caller. See Appendix C for a list of the possible status codes. 



BUFFER ADDRESS — DBUFLO C03043 and DBUFHI C03053 

This 2-byte pointer contains the address of the source or 
destination of the diskette sector data. You need not supply 
an address for the disk status command. The Disk Handler will 
obtain the status and insert the address of the status buffer 
into this field. 



DISK TIMEOUT VALUE — DTIMLO C03063 

The Handler supplies this timeout value (in whole seconds) for 
use by SIO. 



BYTE COUNT — DBYTLO C03083 and DBYTHI C03093 

This 2-byte counter indicates the number of bytes transferred to 
or from the disk as a result of the most recent command/ and is 
set up by the Handler. 



SECTOR NUMBER — DAUXl C030A3 and DAUX2 C030B3 

This 2-byte number specifies the diskette sector number (1 - 720) 
to read or write. DAUXl contains the least significant byte» and 
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DAUX2 contains the most significant byte. 

Diskette Handler Commands 

There are five commands supported by the Diskette Handler: 

GET SECTOR (PUT SECTOR — *** not supported by current handler *«*) 
PUT SECTOR WITH VERIFY 
STATUS REQUEST 
FORMAT DISK 

GET SECTOR (Command byte = *52> 

The Handler reads the specified sector to your buffer and returns the 
operation status. You set the following DCB parameters prior to 
calling the Diskette Handler: 

COMMAND BYTE = *52. 

DEVICE NUMBER = disk drive number (1-4). 

BUFFER ADDRESS = pointer to your 128-byte buffer. 

SECTOR NUMBER = sector number to read. 

Upon return from the sector/ several of the other DCB parameters 
will have been altered. The STATUS BYTE will be the only 
parameter of interest to youi however. 

PUT SECTOR (Command byte = *50) 

»*■»• Not supported by current Handler *** 

(But can be accessed through SIO directly. ) 

The Handler writes the specified sector from your buffer and returns 
the operation status. You set the following DCB parameters prior to 
calling the Diskette Handler: 

COMMAND BYTE = *50. 

DEVICE NUMBER = disk drive number (1-4). 

BUFFER ADDRESS = pointer to your 128 byte buffer. 

SECTOR NUMBER = sector number to write. 

Upon return from the operation* several of the other DCB parameters 
will have been altered. The STATUS BYTE will be the only one of 
interest youi however. 
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PUT SECTOR WITH VERIFY (Command Byte = *57) 

The Handler writes the specified sector from your buffer 
and returns the operation status. This command differs from PUT 
SECTOR in that the diskette controller reads the sector data after 
writing to verify the write operation. Aside from the COMMAND 
BYTE value, the calling sequence is identical to PUT SECTOR. 

STATUS REQUEST (Command byte = *53) 

The Handler obtains a 4--byte status from the diskette controller and 
puts it in system location DVSTAT C02EA3. The operation status 
format is shown below: 



7 

• command stat. 
I hardware stat. 

+-4.-.+-4.~+-.4.-.+-.+-.4. 

I timeout 
i (unused) 



DVSTAT + 
+ 1 
+ 2 
+ 3 



Figure 5-19. DVSTAT 40-Byte Operation Status Format 

The command status contains the following status bits: 

Bit 0=1 indicates an invalid command frame was received. 

Bit 1=1 indicates an invalid data frame was received. 

Bit 2=1 indicates that a PUT operation was unsuccessful. 

Bit 3=1 indicates that the diskette is write protected. 

Bit 4=1 indicates active/standby. 

The hardware status byte contains the status register of the 
INS1771--1 Floppy Diskette Controller chip used in the diskette 
controller. See the documentation for that chip to obtain 
information relating to the meaning of each bit in the byte. 

The timeout byte contains a controller-provided maximum timeout 
value (in seconds) to be used by the Handler. 

You set the following DCB parameters prior to calling 
the Diskette Handler: 

COMMAND BYTE = $53. 

DEVICE NUMBER = disk drive number (1-4). 

Upon return from the operation, several of the other DCB parameters 
will have been altered. The STATUS BYTE will be the only one of 
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interest to youi houiever. 

FORMAT DISK (Command Byte = *21 ) 

The Handler commands the diskette controller to format the entire 
diskette and then to verify it. All bad sector numbers (up to a 
maximum of 63) are returned and put in the supplied buffer* 
followed by two bytes of all 1 's (*FFFF). You set up the 
following DCB parameters prior to calling the Diskette Handler: 

COMMAND BYTE = *21. 

DEVICE NUMBER = disk drive number (l-4>. 

BUFFER ADDRESS = pointer to your 128--byte buffer. 

Upon return* you might be interested in the following DCB parameters 

STATUS BYTE = status of operation. 

BYTE COUNT = number of bytes of bad sector information in 
your buffer* not including the *FFFF terminator. If there 
are no bad sectors* the count will eq,ual zero. 



Serial Bus I/O 



Input/Output to devices other than the keyboard* the screen* and 
the ATARI Computer controller port devices, must utilize the 
Serial I/O bus. This bus contains data* control* and clock lines 
to be used to allow the computer to communicate with external 
devices on this "daisychained" bus. Every device on the bus has 
a unique identifier and will respond only when directly 
addressed. 

The resident system provides a Serial I/O Utility (SIO)* that 
provides a standardized high-level program interface to the bus. 
SIO is utilized by the resident Diskette* Printer* and Cassette 
handlers* and is intended to be used by nonresident handlers (see 
Section 9)* or by applications* as well. For a detailed 
description of the program/SIO interface and for a detailed bus 
specification refer to Section 9. 
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INTERRUPT PROCESSING 



Section 6 describes system actions for the various interrupt 
causing events^ defines the many RAM vectors and provides 
recommended procedures for dealing uiith interrupts. 

The 6502 microcomputer processes three general interrupt types: 
chip-reset# nonmaskable interrupts (NMD and maskable interrupts 
(IRQ). The IRG interrupt type can be enabled and disabled using 
the 6502 CLI and SEI instructions. The NMI type cannot be 
disabled at the processor level; but the NMI interrupts other 
than C SYSTEM. RESET 3 key can be disabled at the ANTIC chip. 

The system events that can cause interrupts are listed below: 

chip-reset - pouier-up 

NMI - Display list interrupt (unused by OS) 
vertical-blank (50/60 Hz) 
C SYSTEM. RESET 3 key 

IRQ - Serial bus output ready 

Serial bus output complete 

Serial bus input ready 

Serial bus proceed line (unused by system) 

Serial bus interrupt line <unused by system) 

POKEY timers i, 2 and 4 

Keyboard key 

CBREAK3 key 

6502 BRK instruction (unused by OS) 

Figure 6-1 List of System-Interrupt Events 
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The chip-reset interrupt is vectored via location FFFC to E477< 
where a JMP vector to the pouier-up routine is located. All NMI 
interrupts are vectored via location FFFA to the NMI interrupt 
service routine at E7B4# and all IRQ interrupts are vectored 
via location FFFE to the IRQ interrupt service routine at E6F3i 
at that point the cause of the interrupt must be determined by 
a series of tests. For some of the events there are built in 
monitor actions and for other events the corresponding 
interrupts are disabled or ignored. The system provides RAM 
vectors so that you can intercept interrupts uihen 
necessary. 



CHIP-RESET 

The OS generates chip-reset in response to a power-up condition. 
The system is completely initialized (see Section 7). 



NONMASKABLE INTERRUPTS 

When an NMI interrupt occursi control is transferred through 
the ROM vector directly to the system NMI interrupt service 
routine. A cause for the interrupt is determined by examining 
hardware register NMIST CD40F3. The NMI makes a jump through the 
global RAM vector VDSLST [02003 if a display list interrupt is 
pending. The OS does not use display list interrupts/ so VDSLST 
is initialized to point to an RTI instruction* and you must not 
change it before VDSLST generates a display interrupt. 

If the interrupt is not a display-list interrupt/ then a test is 
made to see if it is a C SYSTEM. RESET] key interrupt. If so/ then a 
jump is made to the system reset initialization routine (see Section 
7 for details of system reset initialization). 

If the interrupt is neither a display list interrupt nor a 
C SYSTEM. RESET 3 key interrupt; then it is assumed to be a 
vertical-blank (VBLANK) interrupt* and the following actions 
occur: 

Registers A* X and Y are pushed to the stack. 

The interrupt request is cleared (NMIRES CD40F3). 

A jump is made through the "immediate" vertical-blank global 
RAM vector VVBLKI {102223 that normally points to the Stage 1 
VBLANK processor. 

The following actions occur assuming that you have not changed VVBLKI. 
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The stage 1 VBLANK processor is executed. 

The OS tests to see i-P a critical code section has been 
interrupted. If so; then all registers are restored/ and an 
RTI instruction returns from the interrupt to the critical 
section. A critical section is determined by examining the 
CRITIC flag C00423i and the processor I bit. If either are 
set* then the interrupted section is assumed to be critical. 

If the interrupt was not from a critical section* then the 
stage 2 VBLANK processor is executed. 

The OS then jumps through the "deferred" vertical-blank 
global RAM vector VBLKD C02243/ that normally points to the 
VBLANK exit routine. 

The following actions occur assuming that you have not changed VVBLKD. 

o The 6502 A# X and Y registers are restored. 

o An RTI instruction is executed. 



NOTE: You can alter the deferred and immediate 

VBLANK RAM vectors* but still enable normal system processes; or 
restore original vectors without having to save them. The 
instruction at E45F is a JMP to the stage 1 VBLANK processor* the 
address at ££460* 23 is the value normally found in VVBLKI. The 
instruction at E462 is a JMP to the VBLANK exit routine* the 
address at CE463*23 is the value normally found in VVBLKD. These 
ROM vectors to stage 1 VBLANK processor and to the VBLANK exit 
routine will accomplish your goal. 

NOTE: Every VBLANK interrupt jumps through vector VVBLKI. Only 
VBLANK interrupts from noncritical code sections jump through 
vector VVBLKD. 



Stage 1 VBLANK Process 

The following stage 1 VBLANK processing is performed at every 
VBLANK interrupt: 

The stage 1 VBLANK process increments the 3--byte frame 
counter RTCLOK C00i2-00143* RTCLOK+0 is the MSB and RTCLOK+2 
is the LSB. This counter wraps to zero when it overflows 
(every 77 hours or so)# and continues counting. 

The Attract mode variables are processed (see Appendix L» 
B10~12). 

The stage 1 VBLANK process decrements the System Timer 1 
CDTMVl C0218, 23 if it is nonzero; if the timer goes from 
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nonzero to zero then an indirect JSR is performed via CDTMAl 
C0226/23. 



Stage 2 VBLANK Process 

The stage 2 VBLANK processing performs the follouiing for those 
VBLANK interrupts that do not interrupt critical sections: 

The stage 2 VBLANK process clears the 6502 processor I bit. 
This enables the IRQ interrupts. 

The stage 2 VBLANK process updates various hardware 
registers with data from the OS data base< as shown below: 



Data Base 
Item 



Hardware 
Register 



Reason for Update 



SDLSTH 

SDLSTL 

SDMCTL 

CHBAS 

CHACT 

GPRIOR 

COLORO 

COLOR 1 

C0L0R2 

C0L0R3 

COLOR 4 

PCOLRO 

PCOLRl 

PC0LR2 

PC0LR3 



C02313 
C 0230 3 
C022F3 
C02F43 
C02F33 
C026F3 
C02C43 
C02C53 
C:02C63 
C02C73 
C02C83 
[:02C03 
C02Ci3 
C02C23 
C02C33 



DLISTH 

DLISTL 

DMACTL 

CHBASE 

CHACTL 

PRIOR 

COLPFO 

COLPFl 

C0LPF2 

C0LPF3 

COLBK 

COLPMO 

COLPMl 

C0LPM2 

C0LPM3 



CD4033 
CD4023 
CD4003 
CD4093 
CD4013 
CD01B3 
CD0163 
CD0173 
C00183 
ED0193 
CD01A3 
CD0123 
CD0133 
CD0143 
CD0153 



Display list start 



Attract mode, 



Constant = 8 



CONSOL CD01F3 Console speaker off, 



The stage 2 VBLANK process decrements the System Timer 2 
CDTMV2 C021A#23 if it is nonzero; if the timer goes from 
nonzero to zeroi then an indirect JSR is performed 
through CDTMA2 C 0228, 23. 

The stage 2 VBLAMK process decrements System Timers 3* 4 and 
5 if they are nonzero; the corresponding flags are set to 
zero for each timer that changes from nonzero to zero. 
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Timer Timer Value 



Timer Flag 



3 CDTMV3 C021C.23 

4 CDTMV4 C 02 IE/ 23 

5 CDTMV5 C0220, 23 



CDTMF3 C022Ai 13 
CDTMF4 C022C, 13 
CDTMF5 C022E, 13 



A character is read from the POKEY keyboard register and 
stored in CH C02FC3# if auto repeat is active. 

The stage 2 VBLANK process decrements the keyboard debounc< 
counter if it is not equal to zero/ and if no key is 
pressed. 

The stage 2 VBLANK process processes the keyboard auto 
repeat (see Appendix L, E8>. 

The stage 2 VBLANK process reads game controller data from 
the hardware to the RAM data base/ as shomn beloui: 



Hardware 
Reg ister 

PORTA CD3003 



Data Base 
Item 



PORTB CD3013 



POT 

POT 

POT 

POT 

POT 

POT 

POT 

POT 

TRIGO 

TRIGl 

TRI02 

TRIQ3 




1 
2 
3 
4 
5 
6 
7 



CD2003 
CD2013 
CD2023 
CD2033 
CD2043 
CD2053 
CD2063 
CD2073 
CD0013 
CD0023 
CD0033 
CD0043 



STICKO 
STICKl 
PTRIOO 
PTRIGl 
PTRIG2 
PTRIG3 
STICK2 
STICK3 
PTRIG4 
PTRIG5 
PTRIG6 
PTRIG7 
PADDLO 
PADDLl 
PADDL2 
PADDL3 
PADDL4 
PADDL5 
PADDL6 
PADDL7 
STRIGO 
STRIGl 
STRIG2 
STRIG3 



C 0278 3 
C 0279 3 
C027C3 
C027D3 
C027E3 
C027F3 
C 027 A 3 
C027B3 
C 0280 3 
C02813 
C 0282 3 
C 0283 3 
C 0270 3 
C02713 
C 0272 3 
C 0273 3 
C 0274 3 
C 0275 3 
C 0276 3 
C 0277 3 
C 0284 3 
1102853 
C 0286 3 
C 0287 3 



Function 

Joysticks and 
Paddle Controllers 



Paddle Controllers 



Joystick triggers 
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MASKABLE INTERRUPTS 

An IRQ interrupt causes control to be transferred through the 
immediate IRQ global RAM vector VIMIRQ C02163. Ordinarily this 
vector points to the system IRQ Handler. The Handler performs 
these following actions: 

The IRQ Handler determines a cause for the interrupt by 
examining the IRQST tD20El register and the PIA status 
registers PACTL CD3023 and PBCTL CD3033. The interrupt status bit 
is cleared when it is found. One interrupt event is cleaved and 
processed for each interrup t-service entry. If multiple IRQs are 
pending/ then a separate interrupt will be generated for each 
pending IRQ* until all are serviced. 

The system IRQ interrupt service routine deals with each of the 
possible IRQ causing eventsi in the following ways: 

o The 6502 A register is pushed to the stack. 

o If the interrupt is due to serial I/O bus output ready/ 
then clear the interrupt and jump through global RAM 
vector VSEROR C020C3. 

o If the interrupt is due to serial I/O bus input ready/ 
then clear the interrupt and jump through global RAM 
vector VSERIN C020A3. 

o If the interrupt is due to serial I/O bus output 

complete/ then clear the interrupt and jump through 
global RAM vector VSEROC C020E3. 

o If the interrupt is due to POKEY timer #1/ then clear the 
interrupt and jump through global RAM vector VTIMRl C02103. 

o If the interrupt is due to POKEY timer #2/ then clear the 
interrupt and jump through global RAM vector VTIMR2 C02123. 

o If the interrupt is due to POKEY timer #4/ then clear the 
interrupt. The service routine contains a bug/ and falls 
into the following test. 

o If pressing a keyboard key caused the interrupt (other 

than CBREAK3/ CSTART3/ C0PTI0N3/ or CSELECT3); then clear the 
interrupt and jump through global RAM vector VKEYBD C02083. 

o If pressing the CBREAK3 key caused the interrupt; then 

clear the interrupt. Set the BREAK flag BRKKEY C00113 to 
zeroi proceed to clear the following: 

Start/stop flag SSFLAG C02FF3 
Cursor inhibit flag CRSINH C02F03 
Attract mode flag ATRACT C004D3 
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Return from the interrupt after restoring the 6502 A 
register from the stack. 

If the interrupt is due to the serial I/O bus proceed line* 
then clear the interrupt/ and jump through global RAM vector 
VPRCED C02023. 

If the interrupt is due to the serial I/O bus interrupt 
line* then clear the interrupt and jump through global RAM 
vector VINTER C02043. 

If the interrupt is due to a 6502 BRK instruction* then jump 
through global RAM vector VBREAK C02063. 

If none of the above, restore the 6502 A register and return 
from the interrupt (RTI). 



INTERRUPT INITIALIZATION 

The interrupt subsystem completely reinitializes itself whenever 
the system is powered up or the CSYSTEM. RESET3 key is pressed. 
The OS clears the havditiare registers* and sets the interrupt 
global RAM vectors to the following configurations: 



Vector 

VDSLST 
WBLKI 
CDTMAl 
CDTMA2 
WBtKD 

VIMIRQ 
VSEROR 
VSERIN 
VSEROC 
VTIMRl 
VTIMR2 
VTIMR4 
VKEYBD 



C 0200 3 
C 0222 3 
C 0226 3 
£02283 
C 0224 3 

C02163 
C020C3 
C 020 A 3 
C020E3 
C02103 
£02123 
£02143 
£02083 



VPRCED £02023 
VINTER £02043 

VBREAK £02063 



Type Function 

NMI RTI — ignore interrupt. 
System stage 1 VBLANK. 
" SIO timeout timer. 
" No system function. 
" System return from interrupt, 

IRQ System IRQ processor. 

SIO. 

SIO. 

SIO. 
" PLA* RTI — ignore interrupt. 
" PLA* RTI — ignore interrupt. 
" *** doesn't matter *** 
" System keyboard 

interrupt handler. 
" PLA* RTI — ignore interrupt. 
" PLA, RTI — ignore interrupt. 

BRK PLA* RTI — ignore interrupt. 



Figure 6-2 Interrupt RAM Vector Initialization 
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System initialization sets the interrupt enable status 
as follouis: 



NMI 



VBLANK enabledi display list disabled. 



IRQ CBREAK3 key and data key interrupts enabled* all others 
disabled. 



SYSTEM TIMERS 

The OS contains five general purpose software timers* plus an 
OS-supported frame counter. The timers are 2 bytes in length 
Clo, hi> and the frame counter RTCLOK C00123 is three bytes in 
length (hiimid/lo). The timers count downward from any 
nonzero value to zero. Upon reaching zero* they either clear 
an associated flag* or JSR through a RAM vector. The frame 
counter counts upward/ wrapping to zero when it overflows. 

The following table shows the timers and the frame counter 
characteristics: 



Timer Name 



Flag/Vector Use 



CDTMVl 


C02183 


CDTMAl 


C 0226 3 


2-byte 


vector — SIO timeout 


CDTMV2 


i:021A3 


CDTMA2 


C 0228 3 


2-byte 


vector 


CDTMV3 


C021C3 


CDTMF3 


C 022 A 3 


1-byte 


flag 


CDTMV4 


C021E3 


CDTMF4 


C022C3 


1-byte 


flag 


CDTMV5 


C 0220 3 


CDTMF5 


C022E3 


1-byte 


flag 


RTCLOK 


C00123 






3-byte 


frame counter. 



* These two timers are maintained as part of every VBLANK 

interrupt (stage 1 process). The other timers are subject to 
the critical section test (stage~2 process)* that can defer 
their updating to a later VBLANK interrupt. 



USAGE NOTES 

This subsection describes the techniques you need to know in 
order to utilize interrupts in conjunction with the operating 
system. 
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POKEY Interrupt Mask 

ANTIC (display-list and vertical-blank) and PIA (interrupt and 
proceed lines) interrupts can be masked directly (see the 
Hardware Manual). However/ eight bits of a single byte IRQEN 
CD20E3 mask the POKEY interrupts (CBREAK3 key* data key* 
serial input ready/ serial output ready/ serial output done 
and timers 1/2 and 4). 

IRQEN is a write-only register. Thusi u/e must maintain a 
current value of that register in RAM in order to update 
individual mask bits selectively/ while not changing other bits 
The name of the variable used is POKMSK C00103/ and it is used 
as shown in the examples below: 



/ EXAMPLE OF INTERRUPT ENABLE 



SEI 
LDA 
ORA 
STA 
STA 
CLI 



POKMSK 
#$xx 
POKMSK 
IRQEN 



TO AVOID CONFLICT WITH IRQ . . . 
. . . PROCESSOR WHICH ALTERS VAR. 
ENABLE BIT(S). 

TO HARDWARE REG TOO. 



EXAMPLE OF INTERRUPT DISABLE 



SEI 




LDA 


POKMSK 


AND 


#*FF-xx 


STA 


POKMSK 


STA 


IRQEN 


CLI 





TO AVOID CONFLICT WITH IRQ ... 
. . . PROCESSOR WHICH ALTERS VAR 
DISABLE BIT(S). 

TO HARDWARE REGISTER TOO. 



Figure 6-3 POKEY Interrupt Mask Example 

Note that the OS IRQ service routine uses and alters POKMSK* so 
alterations to the variable must be done with interrupts 
inhibited. If done at the interrupt level there is no problem/ as 
the I bit is already set; if done at a background level then the 
SEI and CLI instructions should be used as shown in the examples. 



Setting Interrupt and Timer Vectors 

Because vertical-blank interrupts are generally kept enabled so that 
the frame counter RTCLOK is maintained accurately/ there is a 
problem with setting the VBLANK vectors (VVBLKI and VVBLKD) or 
the timer values (CDTMVl through CDTMV5) directly. A VBLANK 
interrupt could occur when only one byte of the two-byte value had 
been updated/ leading to undesired consequences. For this reason/ 
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the SETVBV CE45F3 routine is provided to perform the desired 
update in safe manner. The calling sequence is shown beloui: 

A = update item indicator 
1-5 for timers 1 ~ 5. 

6 for immediate VBLANK vector WBLKI. 

7 for deferred VBLANK vector VVBLKD. 
X = MSB of value to store. 

Y = LSB of value to store. 

JSR SETVBV 

The Ai X and Y registers can be altered. 

The display list interrupt uiill aluiays be disabled on 

return# even if enabled upon entry. 

It is possible to fully process a vertical-blank interrupt 
during a call to this routine. 

When working with the System Timers* the vectors for timers 1 and 
2 and the flags for timers 3# 4 and 5 should be set while the 
associated timer is equal to zero* then the timer should be set 
to its (nonzero) value. 



Stack Content at Interrupt Vector Points 

The following table shows the stack content at every one of the 
RAM interrupt vector points: 
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RAM STACK CONTENT 



INTERRUPT VECTOR DESCRIPTION 



OS RETURN CONTROL 



VDSLST 


C 0200 3 




WBLKI 


C 0222 3 


* 


CDTMAl 


C 0226 3 




CDTMA2 


C 0228 3 




WBLKD 


C 0224 3 


* 


VIMIRQ 


C02163 


* 


VSEROR 


C020C3 


* 


VSERIN 


C 020 A 3 


* 


VSEROC 


C020E3 


* 


VTIMRl 


C02103 




VTIMR2 


C02123 




VTIMR4 


C02143 




VKEYBD 


C 0208 3 


« 


VPRSED 


C 0202 3 




V INTER 


C 0204 3 




VBREAK 


C 0206 3 





Display list 
VBLANK immediate 
System Timer 1 
System Timer 2 
VBLANK defer. 

IRQ immediate 
Serial out ready 
Serial in ready 
Serial out compare 
POKEY timer 1 
POKEY timer 2 
POKEY timer 4 
Keyboard data 
Serial proceed 
Serial interrupt 
BRK instruction 



return/ P 

return/ P/ A/ X/ Y 

return/ Pi A/ Xi Y/ return 

return/ P/ A/ X/ Y/ return 

return/ P/ A/ X/ Y 



return/ 


P, 


A 


return/ 


P/ 


A 


return/ 


P/ 


A 


return/ 


P/ 


A 


return/ 


P/ 


A 


return/ 


P/ 


A 


return/ 


P/ 


A 


return/ 


P/ 


A 


return/ 


P/ 


A 


return/ 


P/ 


A 


return/ 


P/ 


A 



Figure 6-4 Interrupt and Timer Vector RAM Stack Content Table 

* The OS initializes these entries at power-up. Improperly 
changing these vectors u/ill alter system performance. 



Miscellaneous Considerations 

The following paragraphs list a set of miscellaneous 
considerations for the writer of an interrupt service routine, 



Restrictions on Clearing of "I" Bit 

Display list/ immediate vertical-blank and System Timer #1 
routines should not clear the 6502 I bit. If the NMI leading to 
one of these routines occurred while an IRQ was being processed/ 
then clearing the I bit will cause the IRQ to re-interrupt with 
an unknown result. 

The OS VBLANK processor carefully checks this condition after the 
stage 1 process and before the stage 2 process. 



Interrupt Process Time Restrictions 

You should not write an interrupt routine that exceeds 400 msec 
when added to the stage 1 VBLANK/ if the serial I/O is being 
used. The SIO sets the CRITIC flag while serial bus I/O is in 
progress. 
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Interrupt Delay Due to "WAIT FOR SYNC" 

Whenever a key is read from the keyboard* the Keyboard Handler 
sets WSYNC CD40A3 repeatedly while generating the audible click 
on the console speaker. A problem occurs when interrupts are 
generated during the wait-f or-sync period; the processing of such 
interrupts will be delayed by one horizontal scan line. This 
condition cannot be prevented. You can work around the condition 
by examining the line count VCOUNT CD40B1 and delaying interrupt 
processing by one line when no WSYNC delay has occurred. 



FLOWCHARTS 



The following pages contain process flowcharts showing the main 
events that occur in the NMI and IRQ interrupt processes. 

\ IRQ INTERRUPT PROCESS 



PUSH REG A 
TO STACK 



SERIAL 
OUT RDY? 



CLEAR 
STATUS 



VSEROR 



SERIAL 
IN RDY? 



CLEAR 
STATUS 



VSERIN 



SERIAL 
OUT COMPL? 



CLEAR 
STATUS 



POKEY 
TIMER 1? 



CLEAR 
STATUS 



POKEY 
TIMER 2? 



CLEAR 
STATUS 




POKEY ^"^^0^ 
TIMER 4? S>*' 


CLEAR 
STATUS 




I^< 







KEYBOARD 
KEY? 



CLEAR 
STATUS 



KBD 
HANDLER 
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PULL REG A 
FROM STACK 




(5 



CLEAR STATUS, 

SET BREAK FLG 

CLEAR S/S 



CLEAR 
STATUS 



CLEAR 
STATUS 



VINTER 




h0 
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NMI INTERRUPT PROCESS 





PUSH REG A 
TO STACK 
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SYSTEM INITIALIZATION 



Section 7 discusses the details of the power-up and 
system reset processes. The pouier-up process will be explained 
first, and then the system reset process will be explained in 
terms of its differences from the power-up process. 

Both power-up (also called coldstart) and pressing CSYSTEM. RESET3 
(warmstart) will cause system initialization: In addition, there 
are vectors for these processes at E474 (system reset) and E477 
(power-up) so that they can be user-initiated. 

The power-up initialization process is a superset of the 
system reset initialization process. Power-up initializes both 
the OS and user RAM regions* whereas system reset initializes 
only the OS RAM region. In both cases, the OS calls the outer 
level software initialization entry points allow the application 
to initialize its own variables. 

Pressing the CSYSTEM. RESET 3 key produces an NMI interrupt. It 

does not perform a 6502 chip-reset. If the processor is locked 

up, the CSYSTEM. RESET 3 key cannot be sufficient to unlock it, and the 

system must have power cycled to clear the problem. 



POWER-UP INITIALIZATION (COLDSTART) PROCEDURE 

The OS performs the following functions in the order shown, as 
part of the power-up initialization process: 

1. The following 6502 processor states are set: 

o IRQ interrupts are disabled using the SEI instruction, 
o The decimal flag is cleared using the CLD instruction, 
o The stack pointer is set to *FF. 

2. The OS sets the warmstart flag WARMST C00083 to (false). 
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3. The OS tests to see if a diagnostic cartridge is in the A slot 
o Cartridge address BFFC = 00? 
o The memory at BFFC is not RAM? 
o Bit 7 of the byte at BFFD = 1? 



If all of the above tests are true« then control is passed to 
the diagnostic cartridge via the vector at BFFE. No return is 
expected. 



The OS determines the lowest memory address containing 
non-RAM# by testing the first byte of every 4K "block" to see 
if the content can be complemented. If it can be complemented^ 
then the original value is restored and testing continues. If 
it can't be complemented; then the content is assumed to be 
the first non-RAM address in the system. The MSB of the 
address is stored temporarily in TRAMSZ C00063. 



Zero is stored to all of the hardware register addresses shown 
below (most of that aren't decoded by the hardware): 

DOOO through DOFF 
D200 through D2FF 
D300 through D3FF 
D400 through D4FF 

The OS clears RAM from location 0008, 
determined in step 4* above. 



to the address 



7. The default value for the "noncartr idge" control vector 
DOSVEC C000A3 is set to point to the blackboard routine. At 
the end of initialization, control is passed through this 
vector if a cartridge does not take control. 

8. The coldstart flag COLDST C02443 is set to ~1 (local use). 

9. The screen margins are set: left margin ~ 2/ right margin = 
39, for a 38 character physical line. The maximum line size of 
40 characters can be obtained by setting the margins to and 
39. The OS insets the left margin because the two leftmost 
columns of the video picture on many television sets are not 
entirely visible on the screen. 

10. The interrupt RAM vectors VDSLST t02003 through WBLKD C02243 
are initialized. See Section 6 for the initialization values. 

11. Portions of the OS RAM are set to their required nonzero values 
as shown below: 
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o The CBREAK3 key flag BRKKEY C00113 = ~1 (false). 

o The top of memory pointer MEMTOP C02E53 = the lowest 

non-RAM address (from step 4); MEMTOP will be altered 
later when the Screen Editor is opened in step 15. 

o The bottom of memory pointer MEMLO C02E73 = 0700; MEMLO 
can be changed later if there is either a diskette- or 
cassette-boot operation. 

o The following resident routines are called for initialization: 

Screen Editor 
Display Handler 
Keyboard Handler 
Printer Handler 
Cassette Handler 
Central I/O Monitor (CIO> 
Serial I/O Monitor (SIO) 
Interrupt processor 

o The CSTART3 key is checked* and if pressed/ the cassette-boot 
request flag CKEY C004A3 is set. 

12. 6502 IRQ interrupts are enabled using the CLI instruction. 

13. The device table HATABS C03iA3 is initialized to point to the 
resident handlers. See Section 9 for information relating to 
the Device Handler table. 

14. The cartridge slot addresses for cartridges B and A are 
examined to determine if cartridges are inserted* if RAM does 
not extend into the cartridge address space. 

If the content of location 9FFC is zero* then a JSR is 
executed through the vector at 9FFE/ thus initializing 
cartridge "B". The cartridge is expected to return. 

If the content of location BFFC is zero* then a JSR is 
executed through the vector at BFFE* thus initializing 
cartridge "A". The cartridge is expected to return. 

15. lOCB #0 is set up for an OPEN of the Screen Editor (E) and 
the OPEN is performed. The Screen Editor will use the highest 
portion of RAM for the screen and will adjust MEMTOP 
accordingly. If this operation should fail* the entire 
initialization process is repeated. 

16. A delay is effected to assure that a VBLANK interrupt has 
occurred. This is done so that the screen will be established 
before continuing. 

17. If the cassette-boot request flag is set (see step 11 above), 
then a cassette-boot operation is attempted. See Section 10 
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for details of the cassette-boot operation. 

18. If any of the three conditions stated below existsi an 
attempt is made to boot from the disk. 

There are no cartridges in the slots. 

Cartridge B is inserted and bit of 9FFD is 1. 

Cartridge A is inserted and bit of BFFD is 1. 

See Section 10 for details of the diskette-boot operation. 

19. The coldstart flag COLDST is reset to indicate that the 
coldstart process went to completion. 

20. The initialization process is now complete/ and the 
controlling application is now determined via the remaining 
steps. 

If there is an A cartridge inserted and bit-2 of BFFD is 1/ 
then a JMP is executed through the vector at BFFA. 

Or/ if there is a B cartridge inserted and bit-2 of 9FFD is 
1/ then a JMP is executed through the vector at 9FFA. 

Or/ a jump is executed through the vector DOSVEC that can 
point to the blackboard routine (default case)/ cassette 
booted software or diskette booted software. DOSVEC can be 
altered by the booted software as explained in Section 10. 



SYSTEM RESET INITIALIZATION (WARMSTART) PROCEDURE 

The functions listed below are performed/ in the order shown/ as 
part of the system reset initialization process: 

A. Same as power-up step 1. 

B. The warmstart flag WARMST C00083 is set to -1 (true). 

C. Same as power-up steps 3 through 5. 

D. OS RAM is zeroed from locations 0200-03FF and 0010-007F. 

E. Same as power-up steps 9 through 16. 

F. If a cassette-boot was successfully completed during the 
power-up initialization/ then a JSR is executed through the 
vector CASINI C00023. See Section 10 for details of the 
cassette-boot process. 
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0. Same as power-up step 18/ except instead of booting the 

diskette software/ a JSR is executed through the vector DOSINI 
COOOCJ if the diskette-boot was successfully completed during the 
Power-up initialization. See Section 10 for details of the 
diskette-boot process. 

H. Same as power-up steps 19 and 20. 

Note that the initialization procedures and main entries for ail 
software entities are executed at every system reset as well as 
at power up (see steps 14/ 17/ 18/ 20/ F and G>. If the 
user-supplied initialization/startup code must behave differently 
in response to system reset than it does to power-up/ then the 
warmstart flag WARMS! C00083 should be interrogated; WARMS! = O 
means power-up entry/ else system reset entry. 
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8 FLOATING POINT ARITHMETIC PACKAGE 



This section describes the BCD floating point (FP) package that 
is resident in the OS ROM in both the models 400 and 800. 



The floating point package maintains numbers internally as 6--byte 
quantities: a 5-byte <10 BCD digit) mantissa with a l~byte 
exponent. BCD internal representation uias chosen so that decimal 
division would not lead to the rounding errors typically found in 
binary representation implementations. 

The package provides the following operations: 

ASCII to FP conversion. 

FP to ASCII conversion. 

Integer to FP conversion. 

FP to integer conversion. 

FP add/ subtract/ multiply#and divide. 

FP logarithm/ exponentiation/ and polynomial evaluation. 

FP zero/ load/ store/ and move. 

A floating point operation is performed by calling one of the 
provided routines (each at a fixed address in ROM) after having 
set one or more floating point pseudo registers in RAM. The 
result of the desired operation will also involve floating point 
pseudo registers. The primary pseudo registers are described 
below and their addresses given within the square brackets: 
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FRO COOD43 = 
FRl C00E03 = 
FLPTR C00FC3 = 

INBUFF COOF33 '- 

CIX COOF23 = 

LBUFF C 0580 3 = 



6-byte internal form of FP number. 

6--byte internal form of FP number. 

2~byte pointer (lo/hi) to a FP. 

number. 

2-byte pointer (loihi) to an ASCII text 

buffer. 

i-byte index, used as offset to buffer 

pointed to by INBUFF. 

result buffer for the FASC routine. 



FUNCTIONS/CALLING SEQUENCES 

Descriptions of these floating point routines assume that 
a pseudo register is not altered by a given routine. The 
numbers in square brackets Cxxxx3 are the ROM addresses of 
routines. 



the 



ASCII to Floating Point Conversion (AFP) 

Function: This routine takes an ASCII string as input and 
produces a floating point number in internal form. 

Calling sequence: 

INBUFF = pointer to buffer containing the ASCII 

representation of the number. 
CIX = the buffer offset to the first byte of the ASCII 
number. 

JSR AFP CD8003 

BCS first byte of ASCII number is invalid 

FRO = floating point number. 

CIX = the buffer offset to the first byte after the ASCII 
number. 

Algorithm: The routine takes bytes from the buffer until it 
encounters a byte that cannot be part of the number. The bytes 
scanned to that point are then converted to a floating point 
number. If the first byte encountered is invalids the cavv\i bit 
is set as a flag. 



Floating Point to ASCII Conversion (FASC) 

Function: This routine converts a floating point number from 
internal form to its ASCII representation. 
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Calling sequence: 

FRO = floating point number. 

JSR FASC CD8E63 

INBUFF = pointer to the first byte of the ASCII number. 
The last byte of the ASCII representation has the most 
significant bit (sign bit) set; no EOL follouis. 

Algorithm: The routine converts the number from its internal 
floating point representation to a printable form (ATASCII). The 
pointer INBUFF will point to part of LBUFF/ where the result is 
stored. 



Integer to Floating Point Conversion ( IFF > 

Function: This routine converts a 2-byte unsigned integer (O to 
65535) to floating point internal representation. 

Calling sequence: 

FRO = integer <FRO+0 = LSB, FRO+1 = MSB). 

JSR IFF CD9AA3 

FRO = floating point representation of integer. 



Floating Point to Integer Conversion <FPI) 

Function: This routine converts a positive floating point number 
from its internal representation to the nearest 2~byte integer. 

Calling sequence: 

FRO = floating point number. 

JSR FPI C 09023 

BCS FP number is negative or >= 65535. 5 

FRO = 2-byte integer <FRO+0 = LSB* FRO-H = MSB). 

Algorithm: The routine performs true rounding/ not truncation/ 
during the conversion process. 
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Floating Point Addition <FADD) 

Function: This routine adds two floating point numbers and checks 
the result for out~of~range. 

Calling sequence: 

FRO = floating point number. 
FRl = floating point number. 

JSR FADD CDA663 

BCS out-of-range result. 

FRO = result of FRO + FRl. 
FRl is altered. 



Floating Point Subtraction (FSUB) 

Function: This routine subtracts tuio floating point numbers and 
checks the result for out-of-range. 

Calling sequence: 

FRO = floating point minuend. 
FRl = floating point subtrahend. 

JSR FSUB CDA603 

BCS out~of~range result. 

FRO = result of FRO - FRl. 
FRl is altered. 



Floating Point Multiplication (FMUL) 

Function: This routine multiplies two floating point numbers and 
checks the result for out-of-range. 

Calling sequence: 

FRO = floating point multiplier. 
FRl = floating point multiplicand. 

JSR FMUL CDADB3 

BCS out~of-range result. 

FRO = result of FRO * FRl. 
FRl is altered. 
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Floating Point Division <FDIV> 

Function: This routine divides two floating point numbers and 
checks for division by zero and for result out-of-range. 

Calling sequence: 

FRO = floating point dividend. 
FRl = floating point divisor. 

JSR FDIV CDB283 

BCS out~of-range result or divisor is zero. 

FRO « result of FRO / FRl. 
FRl is altered. 



Floating Point Logarithms (LOO and LOGIO) 

Function: These routines take the natural or base 10 logarithms 
of a floating point number. 

Calling sequence: 

FRO = floating point number. 

JSR LOG CDECD3 for natural logarithm 
or 

JSR LOGIO CDED13 for base 10 logarithm 

BCS negative number or overflow. 

FRO = floating point logarithm. 
FRl is altered. 

Algorithm: Both logarithms are first computed as base 10 
logarithms using a 10 term polynomial approximation; the natural 
logarithm is computed by dividing the base 10 result by the 
constant LOGiO<e). 

The logarithm of a number Z is computed as follotus: 

F * (10 ** Y) = Z where 1 <= F < 10 (normalization). 
L = LOGIO(F) by 10 term polynomial approximation. 
LOGIO(Z) = Y + L. LOG(Z> = LOGIO(Z) / LOGiO(e>. 

NOTE: This routine does not return an error if the number input 
is zero; the LOGIO result in this case is approximately --129. 5* 
which is not useful. 
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Floating Point Exponentiation (EXP and EXPIO) 

Function: This routine exponentiates. 

Calling seq.uence: 

FRO = floating point exponent <Z). 

JSR EXP CDDC03 for e ** Z 
or 

JSR EXPIO CDDCC3 for 10 ** Z 

BCS overflow. 

FRO = floating point result. 
FRl is altered. 

Algorithm: Both exponentials are computed internally as base 10/ 
with the base e exponential using the identity: 
e ** X = 10 ** ( X * LOOlO(e) ). 

The base 10 exponential is evaluated in two parts using the identity 

10 ** X = 10 ** (I + F) = (10 ** I) * (10 ** F) — where I is the 
integer portion of X and F is the fraction. 

The term 10 ** F is evaluated using a polynomial approximation/ 
and 10 ** I is a straightforward modification to the floating 
point exponent. 

Floating Point Polynomial Evaluation (PLYEVL) 

Function: This routine performs an n degree polynomial 
evaluation. 

Calling sequence: 

X/Y = pointer (X = LSB ) to list of FP coefficients (A(i)) 
ordered from high order to low order (six bytes per 
coefficient). 

A = number of coefficients in list. 

FRO ~ floating point independent variable (Z). 

JSR PLYEVL CDD403 

BCS overflow or other error. 

FRO = result of A(n)*Z**n + A(n~i >*Z**n-l ... + A(1>*Z + 

A(0). 
FRl is altered. 

Algorithm: The polynomial P(Z) = SUM(i=0 to n) (A(i>-»Z**i> is 
computed using the standard method shown below: 

P(Z) = (. . . (A(n)*Z + A(n-l))*Z + . . . + A( 1 > )*Z + A(0> 
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Clear FRO (ZFRO) 

Function: This routine sets the contents of pseudo register FRO 
to all zeros. 

Calling sequence: 

JSR ZFRO CDA443 

FRO = zero. 



Clear Page Zero Floating Point Number (ZFl) 

Function: This routine sets the contents of a zero-page floating 
point number to all zeroes. 

Calling sequence: 

X = Zero-page address of FP number to clear. 

JSR ZFl CDA463 

Zero-page FP number(X) = zero. 



Load Floating Point Number to FRO (FLOOR and FLDOP ) 

Function: These routines load pseudo register FRO with the 
floating point number specified by the calling sequence. 

Calling sequences: 

X/ Y = pointer (X = LSB) to FP number. 

JSR FLOOR CDD893 



or 



FLPTR = pointer to FP number, 
JSR FLDOP CDDSDa 



FRO = floating point number (in either case). 
FLPTR = pointer to FP number (in either case) 
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Load Floating Point Number to FRi <FLD1R and FLDIP) 

Function: These routines load pseudo register FRi with the 
floating point number specified by the calling sequence. 

Calling sequences: 

As in prior description/ except the result goes to FRI 
instead of FRO. FLDIR CDD983 and FLDIP tDD9C]f. 



Store Floating Point Number From FRO (FSTOR and FSTOP) 

Function: These routines store the contents of pseudo register 
FRO to the address specified by the calling sequence: 

Calling sequence: 

As in prior descriptions* except the floating point number 
is stored from FRO rather than loaded to FRO. FSTOR CDDA73 
and FSTOP CDDAB3. 



Move Floating Point Number From FRO to FRI (FMOVE) 

Function: This routine moves the floating point number in FRO to 
pseudo register FRI. 

Calling sequence: 

JSR FMOVE tmB61 

FRI = FRO (FRO remains unchanged). 



RESOURCE UTILIZATION 

The floating point package uses the following RAM locations in 
the course of performing the functions described in this section 

00D4 through OOFF 
057E through 05FF 

All of these locations are available for program coding 
if your program does not call the floating point package. 



OPERATING SYSTEM C016555 — Section 8 
128 



IMPLEMENTATION DETAILS 

Floating point numbers are maintained internally as 6--bi|te 
quantities^ u/ith 5 bytes (10 BCD digits) of mantissa and 1 byte 
of exponent. The mantissa is altuays normalized such that the 
most significant byte is nonzero (note "byte" and not "BCD 
digit"). 

The most significant bit of the exponent byte provides the sign 
for the mantissa; for positive and 1 for negative. The 
remaining 7 bits of the exponent byte provide the exponent in 
excess 64 notation. The resulting number represents powers of 100 
decimal (not powers of 10). This storage format allows the 
mantissa to hold 10 BCD digits when the value of the exponent is 
an even power of 10/ and 9 BCD digits when the value of the 
exponent is an odd power of 10. 

The implied decimal point is always to the immediate right of the 
first byte. An exponent less than 64 indicates a number less than 
1. An exponent equal to or greater than 64 represents a number 
equal to or greater than 1. 

Zero is represented by a zero mantissa and a zero exponent. To 
test for a result from any of the standard routines; test either 
the exponent or the first mantissa byte for zero. 

The absolute value of floating point numbers must be greater than 
10**~98/ and less than 10**+98i or be equal to zero. There is 
perfect symmetry between positive and negative numbers with the 
exception that negative zero is never generated. 

The precision of all computations is maintained at 9 or 10 
decimal digitsi but accuracy is somewhat less for those functions 
involving polynomial approximations (logarithm and 
exponentiation). Also* the problems inherent in all floating 
point systems are present here; for example: subtracting two very 
nearly equal numbersi adding numbers of disparate magnitude* or 
successions of any operation* will all result in a loss of 
significant digits. An analysis of the data range and the order 
of evaluation of expressions may be required for some types of 
appl icat ions. 

The examples below compare floating point numbers with their 
internal representations* as an aid to understanding storage 
format. All numbers prior to this point have been expressed in 
decimal notation* but these examples will use hexadecimal 
notation. Note that 64 decimal (the excess number of the 
exponent) is 40 when expressed in hexadecimal: 

Number: +0.02 == 2 * 10**~2 = 2 * 100**-t 

Stored: 3F 02 00 00 00 00 (FP exponent = 40 - 1) 

Number: -0.02 = -2 * 10**--2 = ~2 * 100**-! 

Stored: BF 02 00 00 00 00 (FP exponent = 80 + 40 ~ 1) 
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Number: +37.0 = 3.7 * 10**1 = 37 * 100**0 

Stored: 40 37 00 00 00 00 (FP exponent ==40 + 0) 

Number: -4.60312486 * 10**11 = -46.03... * 100**5 

Stored: C5 46 03 01 24 86 (FP exponent =80+40+5) 

Number: 0. 

Stored: 00 00 00 00 00 00 (special case) 
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9 ADDING NEW DEVICE HANDLERS/PERIPHERALS 

This section describes the interface requirements for a 
nonresident Device Handler that is to be accessed via the Central 
I/O utility <CIO>. The Serial bus I/O utility (SIO> interface is 
defined for those handlers that utilize the Serial I/O bus. 

The I/O subsystem is organized with three levels of software 
between you and your hardware: The CIOi the individual device 
handlersf and the SIO. 

The CIO performs the following functions: 

Logical device name to Device Handler mapping (on OPEN). 

I/O Control Block (lOCB) maintenance. 

Logical record handling. 

User buffer handling. 

The device handlers are below CIO. They perform the 
following functions: 

Device initialization on power-up and system reset. 

Device-dependent support of OPEN and CLOSE commands. 

By te-at-a-time data input and output. 

Device-dependent special operations. 

Device-dependent command support. 

Device data buffer management. 

The SIO is at the bottom level (for Serial I/O bus peripheral 
handlers). It performs the following functions: 

Control of all Serial bus 1/0/ conforming to the bus 
protocol. 

Bus operation retries on errors. 

Return of unified error statuses on error conditions. 
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A separate control structure is used -for communication at each 
interface* as follows: 

User/CIO I/O Control Block (lOCB) 

CIO/Handler Zero-page lOCB (ZIOCB) 

Handler/SIO Device Control Block (DCB) 
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Where: shows a control path. 

**** shows the data structure required for a path. 

Note the following: 

1. The Keyboard/Display/Screen Editor handlers don't use 
SIO. 

2. The Diskette Handler cannot be called directly from CIO. 

3. The DCB is shown twice in the diagram. 

Figure 9-1 I/O Subsystem Flow Diagram 
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DEVICE TABLE 

The device table is a RAM-resident table that contains the 

single-character device name (e.g. K/ D, C, etc), and the 

handler address for each of the handlers known to CIO. The 

table is initialized to contain entries for the following 

resident handlers: Keyboard (K)i Display (S)/ Screen Editor 

(E>/ Cassette (C>/ and Printer (P) at power-up and system reset. To 

install a new handler^ some procedure must insert a device table entry 

after the table is initialized. 

The table format is shown below: 



HATABS C03iA3 



+ 4. 

• device name ! 

+ 4- 

I handler vector I 
+ + 

! table address I 

4. + 

i more 1 

I entries I 

+ 4. 

I zero fill to I 
! end of table i 

+ 4- 



+- one entry 



Figure 9-2 Device Table Format 



This 38-byte table will hold a maximum of 12 entries/ with the 
last 2 bytes being zero. CIO scans the table from the end to 
the beginning (high to low address); so the entry nearest the 
end of the table will take precedence in case of multiple 
occurrences of a device name. . 

The device name for each entry is a single ATASCII character* and 
the handler address points to the handler's vector table* that 
will be described in the following section. 



CIO/HANDLER INTERFACE 

This section describes the interface between the Central I/O 
utility and the individual device handlers that are represented 
in the Device Table (as described in the preceding section). 
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Calling Mechanism 

Each handler has a vector table as shoiun belouf: 



+ + 

+ OPEN vector •♦• (low address) 

4. + 

4- CLOSE vector + 

+ + 

+ GETBYTE vector -4- 

+ 4. 

+ PUTBYTE vector + 

^ + 

+ GETSTAT vector + 

4. 4. 

+ SPECIAL vector + 

4. 4. 

+ JMP init code •*- 

+ -»- (high address) 

4. 4. 



Figure 9-3 Handler Vector Table 

The device table entry for the handler points to the first 
byte of the vector table. 

The first six entries in the table are vectors (lo/hi) that 
contain the address - 1 of the handler routine that handles 
the indicated function. The seventh entry is a 6502 JMP 
instruction to the handler initialization routine. CIO uses 
only the addresses contained in this table for handler entry. 
Each user/CIO command translates to one or more calls to one 
of the handler entries defined in the vector table. 

The vector table provides the handler addresses for certain 
fixed functions to be performed to CIO. In addition/ operation 
parameters also must be passed for most functions. Parameter 
passing is accomplished using the 6502 A/ X/ and Y registers 
and an lOCB in page O named ZIOCB C00203. In general* register 
A is used to pass data* register X contains the index to the 
originating lOCBi and register Y is used to pass status 
information to CIO. The zero-page lOCB/ is a copy of the 
originating lOCB/ but in the course of processing some 
commands/ CIO can alter the buffer address and buffer length 
parameters in ZIOCB/ but not in the originating lOCB (see 
Section 5 for information relating to the originating lOCB). 

See Appendix B for the standard status byte values to be 
returned to CIO in register Y. 
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The following sections describe the CIO/handler interface for 
each of the vectors in the handler vector table. 



Handler Initialization 



the 



NOTE: This entry doesn't appear to have any function for 
nonresident handlers due to a bug in the current OS — th 
device table is cleaved in response to system reset as 
well as power-up. This prevents this entry point from ever 
being called. The rest of this section discusses the 
intended use of this entry point. Conformation would be in 
order to allow compatibility with possible corrected 
versions of the OS in the future. 

The entry was to have been called on all occurrences of 
power-up and system reset/ the handler is to perform 
initialization of its hardware and RAM data using a routine 
that assures proper processing of all CIO commands that follow. 



Functions Supported 

This section describes the functions associated with the first 
six vectors from the handler vector table. This section also 
presents a briefi device-independent description of the 
CIO/handler interface and recommended actions for each function 
vector. 



OPEN 

This entry is called in response to an OPEN command to CIO. The 
handler is expected to validate the OPEN parameters and perform 
any required device initialization associated with a device OPEN. 

At handler entry* the following parameters can be of interest: 

X ~ index to originating lOCB. 

Y = *92 (status = function not implemented by handler). 

ICDNOZ C00213 ~ device number (1-4, for multiple device 

handlers). 
ICBALZ/ICBAHZ C0024/00253 = address of device/filename 

specification. 
ICAX1Z/ICAX2Z COO2A/002B3 = device-specific information. 

The handler attempts to perform the indicated OPEN and 
indicates the status of the operation by the value of the Y 
register. The responsibility for checking for multiple OPENs to 
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the same device or filer uihere it is illegalr lies with the 
handler. 



CLOSE 

This vector table entry is called in response to a CLOSE command 
to CIO. The handler is expected to release any held resources 
that relate specifically to that device/filename* and for output 
files to: 

i> send any data remaining in handler buffers to the device; 

2) mark the end of file 

3) update any associated directories; allocation maps< etc. 

At handler entry; the following parameters can be of interest: 

X = index to originating lOCB. 

Y 5= $92 (status = function not implemented by handler). 

ICDNOZ C00213 = device number < 1-4; for multiple device 

handlers). 
ICAX1Z/ICAX2Z C002A/O02B3 - device-specific information. 

The handler attempts to perform the indicated CLOSE and 
indicates the status of the operation by the value of the Y 
register. 

CIO releases the associated lOCB after the handler returns; 
regardless of the operation status value. 

OETBYTE 

This vector table entry is called in response to a GET 
CHARACTERS or GET RECORD command to CIO. The handler is 
expected to return a single byte in the A register; or return an 
error status in the Y register. 

At handler entry; the following parameters can be of interest: 

X = index to originating lOCB. 

Y = *92 (status = function not implemented by handler). 

ICDNOZ C00213 = device number (1-4; for multiple device handlers). 
ICAX1Z/ICAX2Z COO2A/O02B3 = device-specific information. 

The handler will obtain a data byte directly from the device or from a 
handler-maintained buffer and return to CIO with the byte in the 
A register and the operation status in the Y register. 
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Handlers that do not have short timeouts associated with the 
reading of data (such as the Keyboard and Cassette Handlers)* 
must monitor the CBREAK3 key flag BRKKEY C00113 and return with a 
status of *80 when a CBREAK3 condition occurs. See Appendix L, 
E5; and Section 12 for a discussion of CBREAK3 key monitoring. 

CIO checks for reads from device/files that have not been opened 

or have been opened for output only; the handler will not be called in 

those cases. 

PUTBYTE 

This entry is called in response to a PUT CHARACTERS or PUT 
RECORD command to CIO. The handler is expected to accept a single 
byte in the A register or return an error status in the Y 
register. 

At handler entry/ the following parameters can be of interest: 

X = index to originating lOCB. 

Y = *92 (status = function not implemented by handler). 

A = data byte. 

ICDNOZ C00213 = device number (1-4/ for multiple device 

handlers). 
ICAX1Z/ICAX2Z C002A/002B3 = device-specific information. 

The handler sends the data byte directly to the devicei or to a 
handler-maintained buffer, and returns to CIO with the operation 
status in the Y register. If a handler-maintained buffer fills* 
the handler will send the buffered data to the device before 
returning to CIO. 

CIO checks for WRITEs to device/files that have not been opened/ 

or have been opened for input only. The handler will not be called in 

those cases. 

Now that the normal operation of PUTBYTE has been defined/ a 
special case must be added. Any handler that will operate within 
the environment of the ATARI 8K BASIC language interpreter has a 
different set of rules. Because BASIC can call the handler 
PUTBYTE entry directly, without going through CIO/ the zero-page 
lOCB (ZIOCB) can or may not have a relation to the PUTBYTE call. 
Therefore* the handler must use the outer level lOCB to obtain 
any information that would normally be obtained from ZIOCB. Note 
also that the OPEN protection normally provided by CIO is 
bypassed (i.e. PUTBYTE to a non-OPEN device/file and PUTBYTE to a 
read-only OPEN). 
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GETSTAT 

This entry is called in response to a GET STATUS command to CIO. 
The handler is expected to return four bytes of status to memory 
or return an error status in the Y register. 

At handler entry* the following parameters can be of interest: 

X = index to originating lOCB. Y = *92 (status = function not 
implemented by handler). 

ICDNOZ C00213 =» device number (1-4/ for multiple device handlers) 

ICBALZ/ICBAHZ C0024/00253 = address of 

device/filename specification. 
ICAX1Z/ICAX2Z 
C002A/002B3 = device-specific information. 

The handler gets device status information from the device 
controller and puts the status bytes in DVSTAT C02EA3 through 
DVSTAT+3/ and finally returns to CIO with the operation status 
in register Y. 

The lOCB need not be opened nor closed in order for you 
to request CIO to perform a GET STATUS operation; the handler 
must check where there are restrictions. See Section 5 for a 
discussion of the CIO actions involved with a GET STATUS 
operation using both open and closed lOCB's/ and note the impact 
of this operation on the use of the buffer address parameter. 



SPECIAL 

This handler entry is used to support all functions not handled 
by the other entry points/ such as diskette file RENAME* display 
DRAW/ etc. Specifically/ if the lOCB command byte value is 
greater than *0D/ then CIO will use the SPECIAL entry point. The 
handler must interrogate the command byte to determine if the 
requested operation is supported. 



At handler entry* the following parameters can be of interest: 

X ^ index to originating lOCB. 

Y = *92 (status = function not implemented by handler). 

ICDNOZ E00213 ~ device number (1-4/ for multiple device 

handlers). 
ICCOMZ C00223 = command byte. 
ICBALZ/ICBALH C0024/00253 = buffer address. 
ICBLLZ/ICBLHZ C0028/00293 = buffer length. 
ICAX1Z/ICAX2Z C:002A/002B3 = device-specific information. 
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The handler will perform the indicated operation/ if possible* 
and return to CIO with the operation status in register Y. 

The lOCB need not be opened nor closed in order for you 
to request CIO to perform a SPECIAL operation; the handler 
must check u/here there are restrictions. See Section 5 for a 
discussion of the CIO actions involved with a SPECIAL 
operation using both open and closed lOCB'si and note the 
impact of this on the use of the buffer address parameter. 



Error Handling 

Error handling has been simplified somewhat by having CIO handle 
outer level errors and having SIO handle Serial bus errors/ 
leaving the handler to process the remaining errors. These 
errors include: 

out-of -range parameters. 
CBREAKl key abort. 
Invalid command. 
Read after end of file. 

The current handlers respond to errors using the following 
guidelines: 

They keep the recovery simple (and therefore predictable and 
repeatable). 

They Do not interact directly with you for recovery 
instructions. 

They lose as little data as possible. 

They make all attempts to maintain the integrity of file 
oriented device storage — this involves the initial design 
of the structural elements as well as error recovery 
techniques. 



Resource Allocation 

Nonresident handlers needing code and/or data space in RAM should 
use the techniques listed below/ to assure nonconflict with other 
parts of the OS/ including other nonresident handlers. 
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Zero-Page RAM 

Zero-page RAM has no spare byteS/ and even if there were« there 
is no allocation scheme to support multiple program assignment of 
the spares. Thereforei the nonresident handler must save and 
restore the bytes of zero-page RAM it is going to use. The bytes 
to use must be chosen carefullyi according to the following 
criteria: 

The bytes cannot be accessed by an interrupt routine. 

The bytes cannot be accessed by any noninterrupt code 
betu/een the time the handler modifies the bytes and then 
restores the original values. 

A simple save/restore technique would utilize the stack in a 
manner similar to that shown below: 

LDA COLORS ; (for example) 

PHA i SAVE ON STACK. 

LDA COLCRS+1 

PHA 



LDA 


HPOINT 


STA 


COLCRS 


LDA 


HPOINT+1 


STA 


COLCRS+i 



; HANDLER'S POINTER 



XXX 



( COLCRS >.Y 



DO YOUR POINTER THING. 



STA 


COLCRS-^i 


PLA 




STA 


COLCRS 



RESTORE OLD DATA. 



Note that the Display Handler or Screen Editor should not be 
called before restoring the original value of COLCRS* because 
COLCRS is a variable used by those routines. 

Nonzero-Page RAM 

There is no allocation scheme to support the assignment of 

fixed regions of nonzero-page RAM to any specific process* so the 

handler has three choices: 

1. Make a dynamic allocation at initialization time by 
altering MEMLO C02E73. 

2. Include the variables with the handler for RAM-resident 
handlers. This still involves altering MEMLO at the time 
the handler is booted. 

3. If the handler replaces one of the resident handlers (by 
removing the resident handler's entry in the device 
table)/ then the new handler can use any RAM that the 
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formerly resident handler would have used. 

Stack Space 

In most cases/ there are no restrictions on the use of the stack 

by a handler. Houiever* if the handler plans to push more than a 
couple dozen foytes to the stack; then it should do a stack 

overflow test/ and always leave stack space for interrupt 
processing. 



HANDLER /S 10 INTERFACE 

This section describes the interface between serial bus device 
handlers and the serial bus I/O utility (SIO). SIO completely 
handles all bus transactions following the device-independent bus 
protocol. SIO is responsible for the following functions: 

Bus data format and timing from computer end. 

Error detection/ retries and statuses. 

Bus timeout. 

Transfer of data between the bus and the caller's buffer. 



Calling Mechanism 

SIO has a single entry point SIOV CE4593 for all operations. The 
device control block (DCB) C03003 contains all parameters passed 
to SIO. The DCB contains the following bytes: 

DEVICE BUS ID — DDEVIC C03003 

The bus ID of the device is set by the handler prior to calling 
SIO (see Appendix I>. 

DEVICE UNIT # — DUNIT C03013 

This byte indicates that of n units of a given device type to 
access/ and is set by the handler prior to calling SIO. This 
value usually comes from ICDNOZ. SIO accesses the bus device 
whose address is equal to the value of DDEVIC plus DUNIT minus 1 
(the lowest unit number is normally equal to 1). 

DEVICE COMMAND — DCOMND C03023 

The handler sets this byte prior to calling SIO. It will be sent 
to the bus device as part of the command frame. See Appendix I 
for device command byte values. 
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DEVICE STATUS ~~ DSTATS C 0303 3 

This byte is bidirectional. The handler will use DSTATS to 
indicate to SIO what to do after the command frame is sent and 
acknowledged. SIO will use it to indicate to the handler the 
status of the requested operation. 

Prior to an SIO call: 

7 

4— •+-4—4— +-+-+-•+•— ♦• 

iWIR! unused i 

Where: W# R = 0/0 indicates no data transfer is associated with the 

operation. 
0/ 1 indicates a data frame is expected from the device. 
1/0 indicates a data frame is to be sent to the device. 
1/ 1 is invalid. 



After an SIO call: 

7 

4— 4— 4-4— 4— +-4—4— 4- 

i status code ! 
+-+-+—+-+-+-+-+-+ 

See Appendix C for the possible SIO operation status codes. 

HANDLER BUFFER ADDRESS — - DBUFLO/DBUFHI C0304/03053 

The handler sets this 2-byte pointer. It indicates the source 
or destination buffer for device data or status information. 

DEVICE TIMEOUT -~ DTIMLO C 0306 3 

The handler sets this byte. It specifies the tievice timeout time 
in units of 64/60 of a second. For example/ a count of 6 
specifies a timeout of 6. 4 seconds. 

BUFFER LENGTH/BYTE COUNT -~ DBYTLO/DBYTHI C0308/03093 

The handler sets this 2~byte count for the current 
operation/ and indicates the number of data bytes to be 
transferred into or out of the buffer. This parameter is not 
required if the STATUS byte W and R bits are both zero. These 
values indicate that no data transfer is to take place. 

WARNING: There is a bug in SIO that causes incorrect 
actions when the last byte of a buffer is in a memory 
address ending in *FF/ such as ISFFt 42FF/ etc. 
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AUXILIARY INFORMATION -- DAUX1/DAUX2 C030A/030B3 

The handler sets these 2~bt|tes. The SIO includes them in the bus 
command frame; they have device-specific meanings. 



Functions Supported 

SIO does not examine the COMMAND byte it sends to the device* 
because all bus transactions are expected to conform to a 
universal protocol. The protocol includes three forms* stated 
beloui (as seen from the computer): 

Send command frame. 

Send command frame and send data frame. 

Send command frame and receive data frame. 

The values of the W and R bits in the status byte select the 
command form. 



Error Handling 

SIO handles most of the serial bus errors for the handler* 
as indicated below: 

Bus timeout — SIO provides a uniform command frame and data 
frame ACK byte timeout of 1/60 of a second - / + 1/60. 
The handler specifies the maximum COMPLETE byte timeout 
value in DTIMLO. 

Bus errors — SIO detects and reports UART overrun and 
framing errors. The sensing of these errors in any received 
byte will cause the entire associated frame to be considered 
bad. 

Data frame checksum error — SIO validates the checksum on 
all received data frames and generates a checksum for all 
transmitted frames. 

Invalid response from device — In addition to the error 
conditions stated above* SIO checks that the ACK and 
COMPLETE responses are proper (ACK = *41 and COMPLETE = 
*43). ACK stands for acknowledge. 

Bus operation retries — SIO will attempt one complete command 
retry if the first attempt is not error free* where a complete 
command try consists of up to 14 attempts to send (and 
acknowledge) a command frame* followed by a single attempt to 
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receive the COMPLETE code and possibly a data frame. 

NOTE: There is a bug in the retry logic for data (iirites# 

such that if the command frame is acknowledged by the 

controlleri but the data frame is not acknowledged/ then SIO 
will retry indefinitely. 

Unified error status codes — SIO provides device-independent error 
codes (see Appendix C>. 



SERIAL I/O BUS CHARACTERISTICS AND PROTOCOL 

This section describes: 

o The electrical characteristics of the ATARI 400 
and ATARI 800 Home Computers serial bus 

o The use of the bus to send bytes of data/ 

o The organization of the bytes as "frames" (records)/ 

o The overall command sequences that utilize frames 

and response bytes to provide computer/peripheral communication. 

Hardware/Electrical Characteristics 

The ATARI 400 and the ATARI 800 Home Computers 
communicate with peripheral devices over a 19/200 baud 
asynchronous serial port. The serial port consists of a serial 
DATA OUT (transmission) line/ a serial DATA IN (receiver) line 
and other miscellaneous control lines. 

Data is transmitted and received as 8 bits of serial data (LSB 
sent first) preceded by a logic zero start bit and succeeded 
by a logic one stop bit. The serial DATA OUT is transmitted as 
positive logic (+4v = one/true/high/ Ov = zero/false/low). The 
serial DATA OUT line always assumes its new state when the 
serial CLOCK OUT line goes high; CLOCK OUT then goes low in 
the center of the DATA OUT bit time. 

An end view of the Serial bus connector at the computer or 
peripheral is shown below (the cable connectors would of 
course be a mirror image): 
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2 4 6 8 10 12 

o o o o o o 



1 3 5 7 9 11 13 



where: 1 = computer CLOCK IN. 

2 = computer CLOCK OUT. 

3 « computer DATA IN. 

4 = GND. 

5 = computer DATA OUT. 

6 = GND. 

7 = COMMAND-. 

8 = MOTOR CONTROL. 

9 = PROCEED-. 

10 = 4-5V/READY. 

11 =8 computer AUDIO IN. 

12 « +12v. 

13 = INTERRUPT-. 

Figure 9-4 Serial Bus Connector Pin Descriptions 

CLOCK IN is not used fay the present OS and peripherals. This 
line can be used in future synchronous communications schemes. 

CLOCK OUT is the serial bus clock. CLOCK OUT goes high at the 
start of each DATA OUT bit and returns to low in the middle of 
each bit. 

DATA IN is the serial bus data line to the computer. 

Pin 4 OND is the signal/shield ground line. 

DATA OUT is the serial bus data line from the computer. 

Pin 6 OND is the signal/shield ground line. 

COMMAND- is normally high and goes low when a command frame is 
being sent from the computer. 

MOTOR CONTROL is the cassette motor control line <high=oni 
low= off). 

PROCEED- is not used by the present OS and peripherals; this line 
is pulled high. 

+5v/READY indicates that the computer is turned on and ready. This 
line can also be used as a +5 volt supply of 50ma current rating 
for ATARI peripherals only. 

AUDIO IN accepts an audio signal from the cassette. 

OPERATING SYSTEM C016555 — Section 9 
146 



+ 12V is a +12 volt supply of unknouin current rating for ATARI 
peripherals only. 

INTERRUPT- is not used by the present OS and peripherals; this 
line is pulled high. 

There are no pin reassignments made in the Serial bus cable* 
so pin 3, the computer's DATA IN line» is the peripheral's 
data output line; and similarly for pin 5. 



Serial Port Electrical Specifications 

Peripheral input: 

VIH = 2. Ov min. 
VIL = 0. 4v max. 

IIH = 20ua. max. @ VIH = 2. Ov 
liL = Sua. max. @ VIL = . 4v 

Peripheral output (open collector bipolar): 

VOL = 0. 4v max. € 1.6 ma. 

VOH = 4. 5v min. with external iOOKohm pull-up 

Vcc /READY input: 

VIH = 2. Ov min. @ IIH = Ima. max. 

VIL = 0. 4v max. 

Input goes to logic zero when open. 



Bus Commands 

The bus protocol specifies that all commands must originate from the 
computer* and that peripherals will present data on the bus only when 
commanded to. Every bus operation will go to completion before 
another bus operation is initiated (no overlap). An error detected at 
any point in the command sequence will abort the entire sequence. 

A bus operation consists of the following elements: 

Command frame from the computer. 

Acknowledgement (ACK) from the peripheral. 

Optional data frame to or from the computer. 

Operation complete (COMPLETE) from the peripheral. 
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Command Frame 

The serial bus protocol provides for three types of commands: 1) data 
send/ 2> data receive and 3) immediate (no data — command only). 
There is a common element in all three types/ a command frame 
consisting of five bytes of information sent from the computer 
while the COMMAND- line is held low. The format of the command 
frame is 
shown below: 



device ID 


command 


auxiliary #1 


auxiliary #2 


checksum 



Figure 9-5 Serial Bus Command Frame Format 

The device ID specifies that of the serial bus devices is being 
addressed (see Appendix I for a list of device IDs). 

The command byte contains a device-dependent command (see 
Appendix I for a list of device commands). 

The auxiliary bytes contain more device-dependent information. 

The checksum byte contains the arithmetic sum of the first four 
bytes (with the carry atided back after every addition). 



Command Frame Acknowledge 

The peripheral being addressed would normally respond to a 
command frame by sending an ACK byte (*41) to the computer; if 
there is a problem with the command frame/ the peripheral should 
not respond. 



Data Frame 
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Follottfing the command frame (and ACK) can be an optional data 
frame that is formatted as shown below: 



data I 

bytes \ 

I 
t 

4. 

checksum ! 



This data frame can originate at the computer or at the device 
controller/ depending upon the command. Current device 
controllers expect fixed-length data frames as does the computer* 
where the data frame length is a fixed function of the device 
type and command. 

The checksum value in the data frame is the arithmetic sum of all 
of the frame data preceding the checksum/ with the cavvvi "Prom 
each addition being added back (the same as for the command 
frame). 

In the case of the computer sending a data frame to a peripheral/ 
the peripheral is expected to send an ACK if the data frame is 
acceptable/ and send a NAK ($4E)/ or do nothing if the data frame 
is unacceptable. See the first flowchart in Section 9. 



Operation Complete 

A peripheral is also expected to send an operat ion-COMPLETE byte 
(*43) at the time the commanded operation is complete. The 
location of this byte in the command sequence for each command 
type is shown in the timing diagrams in Section 9. If the 
operation cannot go to normal/ error-free completion/ the 
peripheral should respond with an ERROR byte (*45> instead of 
COMPLETE. 
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Bus Tiffling 

This section provides timing diagrams for the three types of 
command sequences: data send/ data receivei and immediate. 



DATA SEND sequence 



COMMAND- 



4. 



DATA OUT 



4. 4. 

I cmnd i 
•+frame •*- 



; data 
// — + frame 



DATA IN 



+-+ 
I I 

ACK 



4— •+• 



4—+ 



•-»• + — // — + +- 
ACK CMPL 



to 

DATA RECEIVE sequence 

+ 

I 
I 

+ 



COMMAND- 



tl t2 



t3 



t4 



t5 



DATA OUT 



+ + 

I cmnd ! 
—-•■frame +- 



DATA IN 



4—+ 
I I 

.4. + — //. 
ACK 



! ! ! data 
■+ 4—4- frame 
CMPL 



— 4. 



to 



tl t2 



t5 
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IMMEDIATE sequence: 



—• ♦• 



COMMAND- 



•+• + 

DATA OUT I cmnd I 
4-fraaie +■ 



+-+ +--4- 



DATA IN 



ACK CMPL 



to tl t2 tS 

Figure 9-6 Serial Bus Timing Diagram 

The computer generates a delay (tO> between the lowering of COMMAND- 
and the transmission of the first byte of the command frame. 

computer tO (min) = 750 microsec. 
computer tO (max) = 1600 microsec. 

peripheral tO (min) « ?? 
peripheral tO (max) = ?? 

The computer generates a delay (tl) between the transmission of 
the last bit of the command frame and the raising of the COMMAND- 
1 ine. 

computer tl (min) = 650 microsec. 
computer tl (max) = 950 microsec. 

peripheral tl (min) = ?? 
peripheral tl (max) = ?? 

The peripheral generates a delay (t2) between the raising of 
COMMAND- and the transmission of the ACK byte by the peripheral. 

computer t2 (min) = O microsec. 
computer t2 (max) = 16 msec. 

peripheral t2 (min) = ?? 
peripheral t2 (max) = ?? 
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The computer generates a delay (t3> between the receipt of the 
last bit of the ACK byte and the transmission of the first bit of 
the data frame by the computer. 

computer t3 (min) « 1000 microsec. 
computer t3 (max) = 1800 microsec. 

peripheral t3 (min> = ?? 
peripheral t3 <max> = ?? 



The peripheral generates a delay (t4) between the tr 
the last bit of the data frame and the receipt of th 
of the ACK byte by the computer. 



transmission of 
e first bit 



computer t4 (min) = 850 microsec. 
computer t4 (max) = 16 msec. 

peripheral t4 (min) = ?? 
peripheral t4 (max) - ?? 

The Peripheral generates a delay (t5) between the the receipt of 
the last bit of the ACK byte and the first bit of the COMPLETE 
byte by the computer. 

computer t5 (min) = 250 microsec. 

computer t5 (max) =255 sec. (handler-dependent) 

peripheral t5 (min) = ?? 
peripheral t5 (max) = N/A 



HANDLER ENVIRONMENT 

Nonresident handlers can be installed in at least three different 
manners: 

1. As booted software from diskette or cassette. 

2. Resident in a cartridge (A or B). 

3. Downloaded from a serial bus device. 

This section will discuss the basic mechanisms for handler 
installation for these environments. In order to fully utilize the 
information in this sectioni you must have read and understood the 
following sections: 

Program environments Section 3 

RAM region Section 4 

Memory dynamics Section 4 

System initialization Section 7 

Adding new device handlers/peripherals . Section 9 

Program environment and initialization . Section 10 
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Bootable Handler 



The diskette- or cassette-booted software u/ill insert the 
handler's vector table pointer and name to the device table 
whenever the booted software''s initialization entry point is 
entered <on power-up and system reset). Remember that both 
pouier-up and system reset clear the device table of all but the 



resident handler entries. 



Cartridge Resident Handler 

The cartridge software will insert the handler's vector table 
pointer and name to the device table whenever the cartridge's 
initialization entry point is entered (on power-up and 
system reset). Remember that both power-up and system reset 
clear the device table of all but the resident handler entries; 
therefore the device table must be reestablished by the 
handler-initialization procedure upon every entry. 



FLOWCHARTS 

The following pages contain process flowcharts showing the SIO 
and peripheral actions for the Serial bus command forms. 
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PERIPHERAL'S COMMAND FRAME PROCESSING 
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PROGRAM ENVIRONMENT AND INITIALIZATION 



This section discusses possible alternative software environments 
using OS Configurations. Environments other than those discussed 
here are also possible. A thorough understanding of the pouier~up 
and system reset processes (see Section 7> will be necessary to 
evaluate all alternative environments. 



CARTRIDGE 

Most games (and some language processors) are supported via the 
cartridge environment. The cartridge resident software is in 
control of the system/ sometimes using the OS and sometimes not. 
A cartridge can specify whether the diskette is to be booted at 
power-up timei whether the cartridge is to provide the 
controlling software^ or whether the cartridge is a special 
diagnostic cartridge. These options are specified by bits in the 
cartridge header* as shown below: 



4. + 

cartridge 
+- — ♦• 

start address 



00 



option byte 

cartridge 
init address 



--+ 



BFFA (9FFA for cartridge B) 



BFFF (9FFF for cartridge B) 



Figure lO-l Cartridge Header Format 

The byte of "00" is used to allow the OS to determine when a 
cartridge is inserted; locations BFFC and 9FFC will not read zero 
when there is neither RAM at those locations nor a cartridge 
inserted. RAM is differentiated from a cartridge by its ability 
to be altered. 
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The option byte has the following option bits: 

bit =f 0* then do not boot the diskette. 
1, then boot the diskette. 

Bit 2=0/ then init but do not start the cartridge. 
1/ then init and start the cartridge. 

bit 7 = 0/ then cavtvidcie is not a diagnostic cartridge. 

1, then cartridge is a diagnostic cartridge and control 
will be given to the cartridge before any of the OS 
is initialized (JMP (BFFE)). 

The cartridge init address specifies the location to which the OS will 
JSR during all power-up and system reset operations. As a minimum^ 
this vector should point to an RTS instruction. 

The cartridge start address specifies the location to which the OS 
will JMP during all power-up and system reset operations^ if 
bit 1 of the option byte is == i. The application should examine 
the variable WARMST C00083 if system reset action is to be 
different than power-up (WARMST will be zero on power-up and 
nonzero thereafter). 



Cartridge Without Booted Support Package 

A cartridge that does not specify the diskette-boot option and does 
not support the cassette-boot possibility can use lower memory 
(from 0480 to the address in MEMTOP C02E53) in any way it sees 
fit. 



Cartridge With Booted Support Package 

A cartridge that does specify the diskette-boot option or does 
support the cassette-boot possibility must use some care in its 
use of lower memory. The following regions are defined: 

0480-06FF is always available to the cartridge. 
MEMLO/MEMTOP region is always available to the cartridge. 



DISKETTE-BOOTED SOFTWARE 

Software can be booted from the disk drive at power-up time in 
response to one of the following conditions: 
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Neither Cartridge A nor B is inserted. 

Cartridge A is inserted and has bit O of its option byte 
CBFFD3 = i. 

Cartridge B is inserted and has bit of its option byte 
C9FFD3 = 1. 

If any of these conditions are met/ the OS will attempt to read 
the boot record from sector #1 of disk drive 1 and then transfer 
control to the software that was read in. The exact sequence of 
operations will be explained later in this section. 



Diskette-Boot File Format 

The key region of a diskette-boot file is the first six bytes> which 
are formatted as shown below: 



+- 




flags 


-+ 




# 


of sectors 






memory address 




4- 


- 


- 


-4- 




to 


start load 








init 




4- 


- 


- 


-+ 


lA .. 




address 








boot 






continuation 








code 





first byte 



sixth byte 



Figure 10-2 Diskette-Boot File Format 



The first byte is stored in DFLAGS C02403/ but is otherwise 
unused. It should equal zero. 

The second byte contains the number of 128-byte diskette sectors 
to be read as part of the boot process (including the record 
containing this information). This number can range from 1 to 
255/ with O meaning 256. 
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The third and fourth bytes contain the address (IOfhi> at which to 
start loading the first byte of the file. 

The fifth and sixth bytes contain the address <lo/hi> to which the 
booter will transfer control after the boot process is complete 
and whenever the C SYSTEM. RESET 3 key is pressed. 

The Diskette File Management System (FMS) has extra bytes assigned to 
its boot recovdi but this is a special case of the generalized 
diskette-boot and is discussed in Section 5. 

Diskette-Boot Process 

If no cartridge is installed/ then the diskette will follow these 
steps to boot up: 

1. Read the first diskette record to the cassette buffer C04003. 

2. Extract information from the first six bytes: 

Save the flags byte to DFLAOS C0240/13. Save the # of sectors 
to boot to DBSECT C0241il3. Save the load address to BOOTAD 
C0242«23. Save the initialization address in DOSINI COOOCi 23. 

3. Move the record just read to the load address specified. 

4. Read the remaining records directly to the load area. 

5. JSR to the load address-*-6 where a multistage boot process can 
continue. The carry bit indicates the success of this 
operation (carry set = error* carry reset = success). 

NOTE: During step 5i after the initial boot process is 
complete* the booter will transfer control to the seventh byte 
of the first record. The software should continue the boot 
process at this point* if it is a multistage boot. The value 
of MEMLO C02E73 should point to the first free RAM location 
beyond the software just booted. It should be established by 
the booted software as shown below: 



SET UP LSB. 



LDA 


#END+1 


STA 


MEMLO 


STA 


APPMHI 


LDA 


#END+ 1/256 


STA 


MEMLO+1 


STA 


APPMHI+1 



SET UP MSB. 



If the booted software is to take control of the 
system at the end of the boot operation* the 
vector DOSVEC C000A3 must be set up by the 
application at this time* DOSVEC points to the 
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restart entry for the booted application. If the 
booted software is not to take control/ then 
DOSVEC should remain unchanged. 



LDA #RESTRT ; RESTART LSB. 

STA DOSVEC 

LDA #RESTRT/256 

STA DOSVEC +1 



6. JSR indirectly through DOSINI for initialization of the 
application; the application will initialize and return. 

NOTE: The OS enters the initialization point on every 
system reset and power-up. Internal initialization can take 
place during system reset and power-up as well. Initialization 
can also be deferred until Step 7 for controlling 
applications. 



7. JMP indirectly through DOSVEC to transfer control to the 
application. 

NOTE: Pressing the C SYSTEM. RESET 3 key after the application 
is fully booted will cause steps 6 and 7 to be repeated. 



Sample Diskette-Bootable Program Listing 

This skeletal program can be booted from the diskette. It retains 
control when it is entered. 



; THIS IS THE START OF THE PROGRAM FILE. 

PST= *0700 i < OR SOME OTHER LOCATION). 

*= PST ; <.ORG). 



; THIS IS THE diskette-boot CONTROL INFORMATION. 



. BYTE 

. BYTE PND-PST+127/12e 

. WORD PST 

.WORD PINIT 



NUMBER OF RECORDS. 

MEMORY ADDRESS TO START LOAD. 

PROGRAM INIT. 
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; THIS IS THE START OF THE BOOT CONTINUATION. 



LDA 


#PND 


STA 


MEMLO 


STA 


APPMHI 


LDA 


#PND/256 


STA 


MEMLO+i 


STA 


APPMHI+1 


LDA 


#RESTRT 


STA 


DOSVEC 


LDA 


#RESTRT/256 


STA 


DOSVEC +1 


CLC 




RTS 





ESTABLISH LOW MEMORY LIMITS. 



ESTABLISH RESTART VECTOR. 



SET FLAG FOR SUCCESSFUL BOOT. 



; APPLICATION INITIALIZATION ENTRY POINT. 



PINIT RTS 



} NOTHING TO DO HERE FOR . . . 
J . . . CONTROLLING APPLICATION. 



; THE MAIN BODY OF THE PROGRAM FOLLOWS. 

RESTRT=* 

; THE MAIN BODY OF THE PROGRAM ENDS HERE. 



PND= * 

. END 



; 'PND' = NEXT FREE LOCATION. 
Figure 10-3 Diskette-Bootable Program Listing Example 



Program to Create Diskette-Boot Files 

This section provides a program that can be used to make bootable 
files on diskettes. The program given is not the only one possible^ 
and no claims are made as to its elegance. 
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Shown below is a listing of the program to create diskette-boot files, 

THIS PROGRAM WRITES A SINGLE "FILE" TO THE DISKETTE AND IS 
USED IN CONJUNCTION WITH A PROCEDURE TO MAKE DISKETTE- 
BOOTABLE FILES. THE FOLLOWING TWO SYMBOLS MUST BE EQUATED 
USING THE MEMORY LIMITS OF THE PROGRAM TO BE COPIED: 

'PST' = PROGRAM START ADDRESS (SEE SAMPLE PROGRAM). 
'PND' = PROGRAM END ADDRESS (SEE SAMPLE PROGRAM). 



SECSIZ=128 i DISKETTE SECTOR SIZE. 

PST= $0700 

PND= *1324 

FLEN= PND-PST+SECSIZ-1/SECSIZ ; # OF SECTORS IN FILE. 



*ss 



*B000 



; THIS PROGRAM'S ORIGIN. 



BOOTB BRK i *** LOAD APPLICATION *** 

; SET UP DEVICE CONTROL BLOCK FOR DISKETTE HANDLER CALL 

i # OF SECTORS TO WRITE. 

i DISK DRIVE #1. 

; SET UP FOR WRITE WITH CHECK. 

i POINT TO START OF APPLIC. PROG. 



LDA 


#FLEN 


STA 


COUNT 


LDA 


#1 


STA 


DUN IT 


LDA 


#'W 


STA 


DCOMND 


LDA 


#PST 


STA 


DBUFLO 


LDA 


#PST/256 


STA 


DBUFHI 


LDA 


#01 


STA 


DAUXl 


LDA 


#00 


STA 


DAUX2 



SET UP STARTING SECTOR # = 0001. 
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NOW WRITE THE FILE ONE SECTOR AT A TIME. 



BOTOIO 


JSR 


DSKINV 




BMI 


DERR 




LDA 


DBUFLO 




CLC 






ADC 


#SECSIZ 




STA 


DBUFLO 




LDA 


DBUFHI 




ADC 


#0 




STA 


DBUFHI 




INC 


DAUXl 




BNE 


B0T020 




INC 


DAUX2 


B0T020 


DEC 


COUNT 




BNE 


BOTOIO 




BRK 




DERR 


BRK 




COUNT 


«ss«^l 




; THIS 


IS THE 


CARTRIDGE HEADER 


*= 


*BFF9 




INIT 


RTS 






. WORD 


BOOTB 




. BYTE 


0,4 




.WORD 


INIT 



.END 



WRITE ONE SECTOR. 
ERROR. 

INCREMENT MEMORY ADDRESS. 



INCREMENT SECTOR #. 

MORE SECTORS TO WRITE? 
YES. 

STOP WHEN DONE. 

STOP ON ERROR. 

SECTOR COUNT. 

"A" CARTRIDGE. 



CASSETTE-BOOTED SOFTWARE 

You can boot software from the cassette as well as from the 

diskette* at power-up. The following requirements must be met in order 

to boot from the cassette: 

o You must be pressing the CSTART3 key as power is 
applied to the system. 

o A cassette tape with a proper boot format file must be 

installed in the cassette drive» and the PLAY button must be 
pressed. 
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o When you are given the audio prompt by the cassette 
handler you must press the CRETURN3 key. 

If all of these conditions are met/ the OS will read the boot file 
from the cassette and then transfer control to the software that 
was read in. The exact secLuence of operations will be explained 
later in this section. 



Cassette-Boot File Format 

The key region of a cassette-boot file is the first six bytes/ that 
are formatted as shown below: 



# of Records 



Memory Address 

4. — — + 

To Start Load 



Init 
4. — — + 

address 



The first byte is not used by the cassette-boot process. 

The second byte contains the number of 128-byte cassette records to 
be read as part of the boot process (including the record 
containing this information). This number can range from 1 to 255# 
with meaning 256. 

The third and fourth bytes contain the address (lo/hi) to which the 
hooter will transfer control after the boot process is complete and 
whenever the CSYSTEM, RESET3 key is pressed. 

Cassette-Boot Process 

The cassette-boot process is described step-by-step for a 
configuration in that no cartridge is installed and no diskettes are 
attached. For the general case see Section 7. 

1. Read the first cassette record to the cassette buffer. 

2. Extract information from the first six bytes: 
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Save the # of records to boot. Save the load address. Save 
the initialization address in CASINI C00023 

3. Move the record just read to the load address specified. 

4. Read the remaining records directly to the load area. 

5. JSR to the load address+6 uihere a multistage boot process 
can continue; the carry bit uiill indicate the success of 
this operation (carry set«errori carry reset=success ) . 

6. JSR indirectly through CASINI for initialization of the 
application; the application will initialize and return. 

7. JMP indirectly through DOSVEC to transfer control to the 
application. 

Pressing the C SYSTEM. RESET 3 key after the application is fully booted 
will cause steps 6 and 7 to be repeated. 

NOTE: After the initial boot process is complete/ the hooter will 
transfer control to the seventh byte of the first record; at this 
point the software should continue the boot process (if it is a 
multistage boot) and then stop the cassette drive/ which due to a 
system bug will still be running* using the following instruction 
sequence: 

LDA #*3C 

STA PACTL CD3023 
The application should then set a value in MEMLO L02371 that 
points to the first free RAM location beyond the software just 
booted/ as shown below: 



LDA 


#END+1 


STA 


MEMLO 


STA 


APPMHI 


LDA 


#END+i/256 


STA 


MEMLO+1 


STA 


APPMHI +1 



If the booted software is to take control of the system at the end 
of the boot operation/ the vector DOSVEC C000A3 must be set up by 
the application at this time; DOSVEC points to the restart entry 
for the booted application. If the booted software is not to take 
control/ then DOSVEC should remain unchanged. 

LDA #RESTRT ; RESTART LSB 

STA DOSVEC 

LDA #RESTRT/256 

STA DOSVEC +1 



NOTE: The initialization point is entered on every system reset 
and power-up; internal initialization can take place here. 
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For controlling applications initialization can also be deferred 
until step 7. 



Sample Cassette-Bootable Program Listing 

Shown below is a skeletal program that can be booted from the 
cassette and that retains control when it is entered. 

; THIS IS THE START OF THE PROGRAM FILE. 



PST= *0700 
*« PST 



(OR SOME OTHER LOCATION) 
(. ORG). 



THIS IS THE cassette-boot CONTROL INFORMATION. 



. BYTE O 

. BYTE PND-PST+127/128 

. WORD PST 

.WORD PINIT 



(DOESN'T MATTER). 

NUMBER OF RECORDS. 

MEMORY ADDRESS TO START LOAD. 

PROGRAM INIT. 



THIS IS THE START OF THE BOOT CONTINUATION. 



LDA 


#*3C 


STA 


PACTL 


LDA 


#PND 


STA 


MEMLO 


STA 


APPMHI 


LDA 


#PND/256 


STA 


MEMLO+1 


STA 


APPMHI +1 


LDA 


#RESTRT 


STA 


DOSVEC 


LDA 


#RESTRT/256 


STA 


DOSVEC+i 


CLC 




RTS 





STOP THE CASSETTE. 
ESTABLISH LOW MEMORY LIMITS. 



ESTABLISH RESTART VECTOR. 



SET FLAG FOR SUCCESSFUL BOOT. 



APPLICATION INITIALIZATION ENTRY POINT. 



PINIT RTS 



NOTHING TO DO HERE FOR . . . 
. . . CONTROLLING APPLICATION. 



; THE MAIN BODY OF THE PROGRAM FOLLOWS. 

RESTRT=* 

; THE MAIN BODY OF THE PROGRAM ENDS HERE. 
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PND= 



'PND' = NEXT FREE LOCATION. 



END 



Figure 10-4 Sample Cassette-Bootable Program 



Program to Create Cassette-Boot Files 

This section provides a program listing that can be used to make 
bootable files on cassette tapes. The program given is not the only 
one possible^ and no claims are made as to its elegance. 

Shouin below is a listing of the program to create a cassette-boot 
file: 

THIS PROGRAM WRITES A SINGLE FILE TO THE CASSETTE AND IS 
USED IN CONJUNCTION WITH A PROCEDURE TO MAKE CASSETTE- 
BOOTABLE FILES. THE FOLLOWING TWO SYMBOLS MUST BE EQUATED 
USING THE MEMORY LIMITS OF THE PROGRAM TO BE COPIED: 

'PST' = PROGRAM START ADDRESS (SEE SAMPLE PROGRAM). 
'PND' = PROGRAM END ADDRESS (SEE SAMPLE PROGRAM). 



PST= *0700 

PND= *1324 

FLEN= PND-PST-4- 1 27/ 1 28» 1 28 

*= *B000 

BOOTB LDX #*10 



ROUND UP TO MULTIPLE OF 128. 
THIS PROGRAM'S ORIGIN. 
USE lOCB #1. 



i FIRST OPEN THE CASSETTE FILE FOR WRITING. 

i SET UP FOR DEVICE "OPEN. " 

; DIRECTION IS "OUTPUT. " 
; SELECT SHORT IRG. 

; SET UP POINTER TO DEVICE NAME. 



LDA 


#OPEN 


STA 


ICCOMr X 


LDA 


#OPNOT 


STA 


ICAXl, X 


LDA 


#*80 


STA 


ICAX2/ X 


LDA 


#CFILE 


STA 


ICBAL, X 


LDA 


#CFILE/256 


STA 


ICBAH, X 


JSR 


CIOV 


BMI 


CERR 



ATTEMPT TO OPEN FILE. 
ERROR. 



NOW WRITE THE ENTIRE FILE AS ONE OPERATION. 
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LDA 


#PUTCHR 


STA 


ICCOM, X 


LDA 


#PST 


STA 


ICBAL, X 


LDA 


#PST/256 


STA 


ICBAH, X 


LDA 


#FLEN 


STA 


ICBLLi X 


LDA 


#FLEN/256 


STA 


ICBLHi X 


JSR 


CIOV 


BMI 


CERR 



SET UP FOR "PUT CHARACTERS. " 



POINT TO START OF APPLIC. PROG. 



SET UP # OF BYTES TO WRITE. 



WRITE ENTIRE FILE. 
ERROR. 



NOW CLOSE THE FILE AFTER SUCCESSFUL WRITE. 

i SET UP FOR "CLOSE. " 

; CLOSE THE FILE, 

i ERROR. 

; STOP WHEN DONE. 

; STOP ON ERROR. 

i FILE NAME. 

} "A" CARTRIDGE. 





LDA 


#CLOSE 




STA 


ICCOM, X 




JSR 


CIOV 




BMI 


CERR 




BRK 




CERR 


BRK 




CFILE 


. BYTE 


"C: "/CR 


1 THIS 


IS THE 


CARTRIDGE HEADER 


*= 


*BFF9 




INIT 


RTS 






.WORD 


BOOTB 




. BYTE 


0.4 




. WORD 


INIT 




.END 
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11 ADVANCED TECHNIQUES AND APPLICATION NOTES 

This section presents information to use the capabilities of the OS 
and some of the hardware capabilites that aren't directly available 
through the OS /and in fact/ can be in direct conflict with parts of 
the OS. 



SOUND GENERATION 

The OS uses the POKEY sound generation capabilities only in the I/O 
subsystem/ for cassette FSK tone generation/ and for the "noisy 
bus" option in SIO. 



Capabil ities 

The hardware provides four independently programmable audio 
channels that are mixed and sent to the television set as part of 
the composite video signal. The POKEY registers shown below are all 
concerned with sound control (as described in the ATARI Home 
Computer Hardware Manual). 



AUDCTL CD2083 

AUDCl CD2013 and AUDFl CD2003 
AUDC2 CD2033 and AUDF2 CD2023 
AUDC3 CD2053 and AUDF3 CD2043 
AUDC4 CD2073 and AUDF4 CD2063 



Audio control. 
Channel 1 control 
Channel 2 control 
Channel 3 control 
Channel 4 control 



Conflicts With OS 

There are two potential conflicts with the OS involving sound 
generation: 

o The OS can generate its own sounds and then turn off all sounds 
as part of I/O operations to the cassette and the serial bus 
peripherals. 

o The OS does not turn off sounds when you press CSYSTEM. RESET3 or 
CBREAK3. If the sounds are to be turned off under those 
conditions/ the controlling program must provide that capability 
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SCREEN GRAPHICS 



Hardware Capabilities 

The hardware capabilities for screen presentations are quite 
versatile; the OS uses a very small amount of the capability 
provided. The means of extension, however, are non-trivial; and 
making changes to a screen format while still utilizing the 
resident Display Handler will be difficult. See the ATARI Home 
Computer Hardware Manual for information regarding screen 
presentations. 



OS Capabilities 

The resident Display Handler arbitrarily supports 8 of the 11 
possible full screen modes (11 of 14 modes if the GTIA chip is used 
in place of the CTIA). The resident Display Handler allows for an 
optional "split-screen" text window of fixed size. The hardware 
allows for many more options than the Display Handler supports, as 
will be seen by reading the ATARI Home Computer Hardware 
Manual. 



Cursor Control 

You can control the Display Handler text and graphics cursors 
directly (see Section 5 and Appendix L/ Bi-4>. 



Color Control 

You can alter the color register assignments that the Display 
Handler makes upon all OPEN commands (see Appendix L B7-8 and 
elsewhere). Note that every system reset or Display Handler OPEN 
will reset the values back to the system default. 
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Alternate Character Sets 

Two character sets are available in screen text modes 1 and 2. The 
value stored in the data base variable CHBAS C02F43 selects the 
character set of interest to you. The de-Fault value of *E0 
provides capital (uppercase) lettersi numbers and the punctuation 
characters corresponding to display codes $20 through *5F in 
Appendix E). The alternate value of *E2 provides lowercase letters 
and the special character graphics set (corresponding to display 
codes *60 through *7F and *00 through $1F in Appendix E). 

User-defined character sets can also be obtained for text modes 0/ 
1# and 2 by providing the character matrix definitions in RAM and 
setting CHBAS to point to those definitions. CHBAS always contains 
the most significant bits of the memory address of the start of the 
character definitionsi as shown below: 



CHBAS 



7 

+—• ♦— ♦■ ~ + - + — ♦•—4— --»— + 

i MSB !x x! 



Text mode 



i MSB ! X I 



Text modes 1 and 2 



Figure 11-1 User-Defined Character Set Bit Memory Addresses 

(X indicates an ignored address bit 
assumed to be 0. > 



OPERATING SYSTEM C016555 



Section 11 



172 



Each character is defined by an 8 x 8 bit matrix; the 
character '6' is defined as shouin below: 

7 

Byte +~4— +-+•— f- +- +--4—+ 

JOIOIOIOIOIOIOIOI 
•♦•-+-+-+—♦—+--+•-+--+ 
JOIOlllllllllOlO} 1 

{O.'llllOlllllOIOJ 2 

+— ♦—+- +-+-•+-+— +•- 4- 

{ 1 i I 1 { { 1 I 1 1 1 ! 3 
+-+--+~+— ♦—+-+-+-+ 

{OIllllOlllllOIOJ 4 

■♦—4— ♦—+—♦—+--+-+— ♦• 

{OllUIOIOiOIOIOJ 5 

->— 4-- ♦■— + — ».- 4— +-+-+ 

:0!Oll!i!iiliOiO! 6 

4— 4— 4— 4— 4— 4— +~4— -+ 
JOIOIOIOIOIOIOIOI 7 
4- — »-- 4— 4- — >.- 4— +-4--4- 

Figure 11-2 User Defined 8x8 Character Matrix Bit Table 

The storage for the character set involves eight consecutive 
bytes for each character with characters ordered consecutively by 
their internal code value (see the discussion in Appendix L 
relating to B55>. 

4- 4- 

Character base I Character for I 

! code $00 ! 8 bytes 

+ + 

I Character for J 

! code $01 • increasing addresses 

+ 4. 



4- + 

{ Character for I 

! code *7E 

^ ^ 

{ Character for I 

I code $7F I 

4. + 

Figure 11-3 Character Base Diagram 

PLAYER/MISSILE GRAPHICS 

The OS makes no use of the player/missile generation capability 
of the hardware. It can be used independently of the OS with no 
conf 1 ict. 
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Hardware Capabilities 

The hardware allows a number of independently moveable screen 
objects of limited width to be positioned and moved about the 
screen without affecting the "playfield" (bit-mapped graphics or 
character) data. Priority control allows the various objects to 
have a display precedence in case of conflict (overlap). 



Conflicts With OS 

You must assure that the p layer /missi le data is 
address-aligned as required by PMBASE CD4073. You also must 
find a suitable free area that the OS guarantees to be free under 
all environments. 



READIN<? GAME CONTROLLERS 

The OS reads the game controllers (shown below) as part of the 
stage 2 VBLANK process (see Appendix L Jl-9>: 

Joysticks/triggers 1-4. 
Paddle controllers/triggers 1-8. 
Driving controllers/triggers 1-4. 
Light pen/trigger 

In addition to these controllers/ other information can be sensed 
or sent using the PIA chip to that the console connectors are 
interfaced. 



Keyboard Controller Sensing 

Data can be read from an ATARI keyboard controller connected to the 
first port. This program alters registers on a chip called a PIA. 
To set these back to the default values to do further I/Oi hit 
CSYSTEM. RESET3 or POKE PACTLi 60. If this program is to be loaded from 
diskette! use LOAD* not RUN and wait for the busy light on the disk 
drive to go out. Do not execute the program before this light goes 
outi otherwise the diskette continues to spin. 

1 GRAPHICS 

5 PRINT : PRINT " KEYBOARD CONTROLLER DEMO" 

10 DIM R0W(3)i I*(i3), BUTT0N*(1) 

30 GOSUB 6000 

40 FOR CNT=1 TO 4 

60 POSITION 2, CNT*2+5:PRINT "CONTROLLER # ";CNT;":"; 
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70 NEXT CNT 

80 FOR CNT=1 TO 4: GOSUB 7000: POSITION 19, CNT+CNT+5: PRINT BUTTON*; 

:NEXT CNT 
120 GOTO 80 

6000 REM ** SET UP FOR CONTROLLERS ** 

6010 P0RTA=54016: P0RTB=54017: PACTL=54018: PBCTL=54019 
6020 POKE PACTL. 48:P0KE PORTA, 255: POKE PACTL, 52: POKE PORTA, 221 
6025 POKE PBCTL,48:P0KEP0RTB.255:P0KE PBCTL, 52: POKE P0RTB,221 
6030 R0W(0>=238:R0W(1)=221:R0W(2>=187:R0W<3)=119 
6040 I*=" 123456789*0#" 
6050 RETURN 

7000 REM ** RETURN BUTTON* WITH CHARACTER FOR BUTTON WHICH HAS 
BEEN PRESSED ON CONTROLLER CNT (1-4). ** 

7001 REM ** NOTE: A 1 WILL BE RETURNED IF NO CONTROLLER IS 
CONNECTED. ** 

7002 REM ** A SPACE WILL BE RETURNED IF THE CONTROLLER IS 
CONNECTED BUT NO KEY HAS BEEN PRESSED. ** 

7003 PORT=PORTA: IF CNT>2 THEN PORT=PORTB 
7005 P=l 

7008 PA0=CNT-»-CNT~2 

7010 FOR J=:0 TO 3 

7020 POKE PORT, ROW(J) 

7030 FOR 1=1 TO 10: NEXT I 

7050 IF P ADDLE <PA0-*-l)>10 THEN P=J+J+J-i-2: GOTO 7090 

7060 IF PADDLE (PAO)> 10 THEN P=J+J+J+3: GOTO 7090 

7070 IF STRIG(CNT~1>=0 THEN P«J+J-*-J+4: GOTO 7090 

7080 NEXT J 

7090 BUTTON*=I *(P,P) 

7095 RETURN 

Figure 11-4 Reading Data From an ATARI Keyboard Controller 
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The table faeloui shows the variable/register values used for reading a 
keyboard controller from each of the four controller ports. 



!d 
!b 
+-• 
I 

id 
ib 
+- 



Port 1 
+-+-.4. -.4. -4. -.4. -.4.-4., 

PORT A I 
irectioni OF 
its I 

+~+--4— >•— +- •4—4— +- 

PORT B I 
irectioni - 
its ! 



Port 3 
•4— +-+-+- 



Port 4 

•♦•—•+—+ ~-4' — + 



Port 2 
•4—4—+-+- 
I 

I FO 



.4.~.4.._4..._4....4....4.~.4. — ^..4...4.^4....4.>.4. 



■4—4—4- 
EF, DP 

BFi 7F 



4._4._4— 4.-.4.--.4._4.-4.-4.. 



4— 4— 4— 4— 4— 4— 4— 4— 

1 Port A I FE, FD, 
I row sel I FBiF7 
I ect I 

+-4~4-~-4— 4^ 

I Port B I I 

I row se~ I ~ I - 

{ lect I i 

+-4—4—4—4— 4— 4— 4— 4— 4—- 4— 4- — h" 

I Column IIPADDLI {PADDL3 
! Sense i i 

+-4— 4— 4— 4— 4— 4— 4— 4— 4— 4— 4-~4" 

1 Column 2IPADDL0 IPADDL2 
! Sense ! ! 
4— 4— 4— 4— 4— 4—4— 4— 4—4— 4—4— 4- 
I Column 3JSTRIG0 JSTRIOl 
! Sense ' ! 

4—4—4—4—4—4- — h~4—4— 



OF 



•4'--4— 4— 4— 



•4—4—4— 

FE. FDi 

FBIF7 



•4—4—4- — I— -4• 
IPADDL5 

I 
I 

•4—4—4—4- 

fPADDL4 



4.-4 — 4..-.4._4, 



.4— 4— •4- — H- 
{STRIG2 



FO 



•4— 4—4— •4- 



BF, 7F I 

I 
I 

•4— 4—4— 4- 

PADDL7 { 

I 
I 

— 4— 4— +-4- 

PADDL6 { 



4— 4— 4— 4--4 

STRI03 { 



4. -.4.-4. -.4.-4. -.4.-4. — >.-.4.-.4.-.4.-4.~4. 



Figure 11-5 



ATARI Keyboard Controller Variable/Register Value 
Table 



Front Panel Connectors as I/O Ports 

The three pages that follow show how some of the pins in the front 
panel (game controller) connectors can be used as general I/O pins. 



Hardware Information 



PIA (6520 / 6820) 
Out: TTL levelsi 



In 



i load 



TTL levels* 1 load 



For more information refer 
to 6520 chip manual. 
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Port A Circuit (typical) 



6520 



port 



220 



J^ 



jack 



Port B Circuit (typical) 

-»-5 
4. 7K 



6520 



(B) 



Port 



■AAAn lljack 



Male connector* FRONT view 

Pin 8 = <»round 

Pin 7 = ^cc 8+5v *> 

Note: 50mA maximum 
total external drain 
on power supply allowed 



"Trigger" Port Circuit (typical): 

II Jack 



CTIA Trig 



220 
-VAr 



^ 



001 



Software Information 



6520 PIA: (This also pertains to all of the following: **) 
Port A control (address D302) 



7 6 



O 









1 


1 


1 


X 









Write this into this register 



Port A Data/Data direction addres 
ing control 

= Data Direction is at D300 

1 = data is at D300 



Port A data direction (address D300) 
7 6 5 4 3 2 10 

Write this into this register. 



iAiAiiiik 



Data direction control 
for Port A 

i = Out 

= In 
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Port A data (address D300> 
7 6 5 4 3 2 10 



43214321 
^ ^^ >' ^ ^^ ^ 

Jack 2 Jack 1 
Pin Numbers 



Read or Write this register 



Port B Control (address D303) 









1 


1 


1 


X 









6520 PIA: 

Port B Control (address D303) 
7 6 5 4 3 2 10 









1 


1 


1 


X 









write this into this register 



Port B Data/Data direction 

addressing control 

= D301 contains data 

d irection 

1 = *D301 contains 



Port B data direction (address D301 ) 
7 6 5 4 3 2 1 



write this into this register 



-data direction control for Port B 
1 = Out 
= In 



Port B data (address D301 ) 
7 6 5 4 3 2 10 



4 3 2 
V 



14 3 2 1 



Jack4 Jack3 
Pin Numbers 



Four "Trigger" ports: DOlO, DOll, D012, D013 
7 6 5 4 3 2 10 

Read this port 
























X 



L — Tri 



gger Value 
DOlO = Port 1 Pin 6 
D013 ~ Port 4 pin 6 
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other Miscellaneous Software Information 



1). The OS sets up all PIA ports as inputs during 

initialization. 
2>. The OS usually reads the above once per television frame 

(during 

vertical-blank) into RAM as follows: 



Data Base Name 
STICKO 

STICKl 
STICK2 
STICKS 
STRIGO 

STRIGl 
STRIG2 
STRIG3 
PADDLl 

PADDL3 
PADDL5 
PADDL7 
PADDLO 
PADDL2 
PADDL4 
PADDL 6 



Address 
0278 

0729 
027A 
027B 
0284 

0285 
0286 
0287 
0270 

0272 
0274 
0276 
0271 
0273 
0275 
0277 



Data 



5 4 3 2 



















X 


X 


X 


X 



4 3 2 



























3 2 



XXXXXXXX 



Pins S 

Jack 1/ pins 4i 3, 2, 
if 10053,7 



Jack 2/ Pins 4, 3, 2, 1 

Jack 3, Pins 4» 3, 2i 1 

Jack 4# Pins 4i 3, 2, 1 

Jack 1, Pin 6 

Jack 2/ Pin 6 

Jack 3i Pin 6 

Jack 4i Pin 6 

Jack li Pin 5 

Jack 2, Pin 5 

Jack 3i Pin 5 

Jack 4/ Pin 5 

Jack 1, Pin 9 

Jack 2/ Pin 9 

Jack 3, Pin 9 

Jack 4/ Pin 9 



Figure 11-6 Using Front Panel Connectors As I/O Ports: Pin 

Function Tables 

* Pins 5 and 9 are read through the paddle controller circuitry 
a nominal value of 7 indicates that the pin is high (or floating) 
and a nominal value of 228 indicates that the pin is pulled low. 
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Appendix A -- CIO COMMAND BYTE VALUES 

The folloufing hex values are known to foe legitimate CIO commands, 

Most handlers: 

03 — OPEN 

05 — GET RECORD 

07 — GET CHARACTERS 

09 — PUT RECORD 

OB — PUT CHARACTERS 

OC -— CLOSE 

OD — GET STATUS 

Display Handler only: 

11 — FILL 

12 -— DRAW 

Diskette File Manager only: 

20 — RENAME 

21 — DELETE 

22 — FORMAT 

23 — LOCK 

24 -- UNLOCK 

25 -- POINT 

26 -- NOTE 
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Appendix B — CIO STATUS BYTE VALUES 

Shown foelow are the known CIO STATUS BYTE values 
01 (001 > — OPERATION COMPLETE (NO ERRORS) 

- C BREAK 3 KEY ABORT 

- lOCB ALREADY IN USE (OPEN) 

- NON-EXISTENT DEVICE 

- OPENED FOR WRITE ONLY 

- INVALID COMMAND 

- DEVICE OR FILE NOT OPEN 

- INVALID lOCB NUMBER (Y reg only) 

- OPENED FOR READ ONLY 

- END OF FILE 

- TRUNCATED RECORD 

- DEVICE TIMEOUT (DOESN'T RESPOND) 

- DEVICE NAK 

- SERIAL BUS INPUT FRAMING ERROR 

- CURSOR out-of-range 

- SERIAL BUS DATA FRAME OVERRUN ERROR 

- SERIAL BUS DATA FRAME CHECKSUM ERROR 

- DEVICE DONE ERROR 

- BAD SCREEN MODE 

- FUNCTION NOT SUPPORTED BY HANDLER 

- INSUFFICIENT MEMORY FOR SCREEN MODE 

- DISK DRIVE # ERROR 

- TOO MANY OPEN DISK FILES 

- DISK FULL 

- FATAL DISK I/O ERROR 

- INTERNAL FILE # MISMATCH 

- FILE NAME ERROR 

- POINT DATA LENGTH ERROR 

- FILE LOCKED 

- COMMAND INVALID FOR DISK 

- DIRECTORY FULL (64 FILES) 

- FILE NOT FOUND 

- POINT INVALID 



80 


(128) 


81 


(129) 


82 


(130) 


83 


(131) 


84 


(132) 


85 


(133) 


86 


(134) 


87 


(135) 


88 


(136) 


89 


(137) 


8A 


(138) 


8B 


(139) 


8C 


(140) 


8D 


(141) 


8E 


(142) 


8F 


(143) 


90 


(144) 


91 


(145) 


92 


(146) 


93 


(147) 


AO 


(160) 


Al 


(161) 


A2 


(162) 


A3 


(163) 


A4 


(164) 


A5 


(165) 


A6 


(166) 


A7 


(167) 


A8 


(168) 


A9 


(169) 


AA 


(170) 


AB 


(171) 



OPERATING SYSTEM C016555 -- Appendix B 

181 



Appendix C -- SIO STATUS BYTE VALUES 

Shown below are the known SIO STATUS BYTE hexadecimal values. 

01 (001) — OPERATION COMPLETE (NO ERRORS) 

8A (138) — DEVICE TIMEOUT (DOESN'T RESPOND) 

SB (139) — DEVICE NAK 

8C (140) — SERIAL BUS INPUT FRAMING ERROR 

8E (142) — SERIAL BUS DATA FRAME OVERRUN ERROR 

8F (143) — SERIAL BUS DATA FRAME CHECKSUM ERROR 

90 (144) -— DEVICE DONE ERROR 
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Appendix D — ATASCII CODES 





0X 


2X 


4X 


6X 


8X 


AX 


CX 


EX 


f^0 


O 


Space 


@ 


a 










01 


19 


1 


A 


a 










02 


O 


II 


B 


b 










03 


a 


# 


C 


c 










J2f4 


o 


$ 


D 


d 










05 


a 


% 


E 


e 










06 


Q 


& 


F 


f " 










01 


S 


1 


G 


g 










i2f8 


O 


( 


H 


h 










09 


e 


) 


I 


i 










0A 


C5 


* 


J 


j 










0B 


6 


+ 


K 


k 










0C 


a 


1 


L 


1 










0D 


a 


- 


M 


m 










0E 


B 


• 


N 


n 










0F 


a 


/ 





o 










10 


Q 





P 


P 










11 


O 


1 


Q 


q 










12 


O 


2 


R 


r 










13 


Q 


3 


S 


s 










14 


□ 


4 


T 


t 










15 


O 


5 


U 


u 










16 


o 


6 


V 


V 










17 


Q 


7 


w 


w 










18 


G9 


8 


X 


X 










19 


01 


9 


Y 


y 










lA 


o 

ESC 


• 


z 


z 










IB 


• 
1 


C 


Q 


EOL 








IC 


Q 
O 


< 


\ 

3 




ElbE 
E?§E 








ID 


CLEAR 


BELL 


IE 


Q 


> 


/\ 


BACKSP 


m 






es&R 


IF 


Q 


? 


- 


TAB 


m 






5S^R 
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ppendi x 


E — DISPLAY CODES (ATASCII) 
















0X 2X 


4X 


6X 


8X AX CX EX 


00 


O 


Space 


@ 


O 










01 


19 


1 


A 


a 










02 


I) 


II 


B 


b 










03 


a 


# 


C 


c 










0A 


a 


$ 


D 


d 










05 


a 


% 


E 


e 










06 


Q 


& 


F 


f 










01 


Q 


1 


G 


g 










J2f8 


B 


( 


H 


h 










09 


e 


) 


I 


i 










0A 


C5 


* 


J 


J 










0B 


S 


+ 


K 


k 










0C 


a 


/ 


L 


1 










0D 


a 


- 


M 


m 










0E 


B 
9 


• 

/ 





n 
o 




^ 










0F 




CODES 80-FF SHOW AS 
THF, INVERSE VIDEO 




10 





1 


P 
Q 


P 

q 




X L J.X-J -X Jd V J_l ,L\.L^ XJ V .J. .U/J_J V/ 

OF CODES 00- 7F 




11 














12 


Q 


2 


R 


r 










13 


Q 


3 


S 


s 










14 


Q 


4 


T 


t 










15 


B 


5 


U 


u 










16 


n 


6 


V 


V 










17 


a 


7 


W 


w 










18 


Q 


8 


X 


X 










19 


ij 


9 


Y 


y 










lA 


o 


» 


Z 


z 










IB 


1^ 


f 


c 


o 










IC 


o 


<: 


\ 


1 










ID 


Q 


= 


n 


□ 










IE 


Q 


p=' 


A^ 


□ 










IF 


Q 


7 


— 


n 
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Appendix F — KEYBOARD CODES (ATASCII) 



CTRL 

00 r 20 

01 A 3F 

02 B 15 

03 C 12 

04 D 3A 

05 E 2A 

06 F 38 

07 3D 

08 H 39 

09 I OD 
OA J 01 
OB K 05 
OC L 00 
OD M 25 
OE N 23 
OF O 08 

10 P OA 

11 Q 2F 

12 R 28 

13 S 3E 

14 T 2D 

15 U OB 

16 V 10 

17 W 2E 

18 X 16 

19 Y 2B 
lA Z 17 
IB <esc> IC 
IC ^<:up> OE 
ID ^•Cdown> OF 
IE -^-Cleft:* 06 
IF '^<:right>07 



SHIFT & 
LOWER 

20 <space> 21 

21 ! IF 

22 " IE 

23 # lA 

24 « 18 

25 7. ID 

26 tk IB 

27 ' 33 

28 ( 30 

29 ) 32 
2A * 07 
2B + 06 
2C , 20 
2D - OE 
2E 22 
2F / 26 

30 O 32 

31 1 IF 

32 2 IE 

33 3 lA 

34 4 18 

35 5 ID 

36 6 IB 

37 7 33 

38 8 35 

39 9 30 
3A 02 
3B ; OD 
3C < 36 
3D = OF 
3E > 37 
3F ? 26 



SHIFT 



LOWER 



40 


@ 


35 


60 


/*. 


22 


41 


A 


3F 


61 


a 


3F 


42 


B 


15 


62 


b 


15 


43 


C 


12 


63 


c 


12 


44 


D 


3A 


64 


d 


3A 


45 


E 


2A 


65 


e 


2A 


46 


F 


38 


66 


f 


38 


47 


G 


3D 


67 


9 


3D 


48 


H 


39 


68 


h 


39 


49 


I 


OD 


69 


i 


OD 


4A 


J 


01 


6A 


J 


01 


4B 


K 


05 


6B 


k 


05 


4C 


L 


00 


6C 


I 


00 


4D 


M 


25 


6D 


m 


25 


4E 


N 


23 


6E 


n 


23 


4F 





08 


6F 





08 


50 


P 


OA 


70 


P 


OA 


51 


G 


2F 


71 


q 


2F 


52 


R 


28 


72 


r 


28 


53 


S 


3E 


73 


s 


3E 


54 


T 


2D 


74 


t 


2D 


55 


U 


OB 


75 


u 


OB 


56 


V 


10 


76 


V 


10 


57 


W 


2E 


77 


Ul 


2E 


58 


X 


16 


78 


X 


16 


59 


Y 


2B 


79 


y 


2B 


5A 


Z 


17 


7A 


z 


17 


5B 


C 


20 


7B 


i 


02 


5C 


\ 


06 


7C 


t 
f 


OF 


5D 


1 


22 


7D 


<cl8ar> 


36 


5E 


/\ 


07 


7E 


<:back> 


34 


5F 




OE 


7F 


<tab> 


2C 



80-9 A /{\ 00-1 A 
9B <return> and ''3 
9C s<del> 34 
9D s<insert>37 
9E -^-Ctab:* 2C 



OC, lA 



9F s<:tab> 2C 

AO-FC / { \ 20-7C 

FD "^2 IE 

FE ^<6el> 34 



FF 



;insert>37 



<clear> ::= s< or '"•C 

<return> : : = <return> or s<return> or "•Creturn> 

•Cesc> : : = <esc> or s<esc> or 'Xesc> 

<5pace> ::= <space> or s<space> or 'Xspace> 

Where: s as a prefix indicates tSHIFT3. 
"• as a prefix indicates CCTRL3. 
/I\ as a prefix indicates ATARI key inverse active. 
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Appendix G — PRINTER CODES (ATASCII) 

Character set for "normal" mode printing: 
20 <space> 40 



2i 


1 


22 


II 


23 


# 


24 


% 


25 


7- 


26 


& 


27 


/ 


28 


( 


29 


> 


2A 


* 


2B 


+ 


2C 


1 


2D 


- 


2E 


. 


2F 


/ 


30 





31 


1 


32 


2 


33 


3 


34 


4 


35 


5 


36 


6 


37 


7 


38 


8 


39 


9 


3A 




3B 


i 


3C 


< 


3D 


ss 


3E 


> 


3F 


7 



40 


@ 


41 


A 


42 


B 


43 


C 


44 


D 


45 


E 


46 


F 


47 


G 


48 


H 


49 


I 


4A 


J 


40 


K 


4C 


L 


4D 


M 


4E 


N 


4F 





50 


P 


51 


Q 


52 


R 


53 


8 


54 


T 


55 


U 


56 


V 


57 


w 


58 


X 


59 


Y 


5A 


Z 


5B 


I 


5C 


\ 


5D 


3 


5E 


/*. 


5F 





60 


% 


61 


a 


62 


b 


63 


c 


64 


d 


65 


e 


66 


f 


67 


9 


68 


h 


69 


i 


6A 


J 


6B 


k 


6C 


I 


6D 


m 


6E 


n 


6F 





70 


P 


71 


q 


72 


r 


73 


s 


74 


t 


75 


u 


76 


V 


77 


Ui 


78 


X 


79 


y 


7A 


z 


7B 


< 


7C 


1 
1 


7D 


> 


7E 


'V 


7F 


<space> 



Note: The follouiing codes print differently than defined by 
the ATASCII definition. 

00 through IF print blank. 

60 prints ^ instead of "diamond". 

7B prints < instead of "spade". 

7D prints > instead of "clear". 

7E prints '^ instead of "backspace". 

7F prints blank instead of "tab". 
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Character set for "sideways" mode printing 



30 





31 


1 


32 


2 


33 


3 


34 


4 


35 


5 


36 


6 


37 


7 


38 


8 


39 


9 


3A 


: 


3B 


i 


3C 


< 


3D 


s 


3E 


> 


3F 


? 



40 


@ 


60 


@ 


41 


A 


61 


A 


42 


B 


62 


B 


43 


C 


63 


C 


44 


D 


64 


D 


45 


E 


65 


E 


46 


F 


66 


F 


47 


G 


67 


G 


48 


H 


68 


H 


49 


I 


69 


I 


4A 


J 


6A 


J 


4B 


K 


6B 


K 


4C 


L 


6C 


L 


4D 


M 


6D 


M 


4E 


N 


6E 


N 


4F 





6F 





50 


P 


70 


P 


51 


Q 


71 


Q 


52 


R 


72 


R 


53 


S 


73 


S 


54 


T 


74 


T 


55 


U 


75 


U 


56 


V 


76 


V 


57 


w 


77 


w 


58 


X 


78 


X 


59 


Y 


79 


Y 


5A 


Z 


7A 


Z 


5B 


C 


7B 


C 


5C 


\ 


7C 


\ 


5D 


3 


7D 


3 


5E 


<up> 


7E 


<up> 



5F <left> 7F <left> 

Note: the following codes print differently than defined by 
the ATASCII definition. 

00 through 2F print blank. 

5E prints "up arrow" instead of 

5F prints "left arrow" instead of _. 

60 through 7F repeats 40 through 5F instead of proper set, 
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Appendix H -— SCREEN MODE CHARACTERISTICS 



Mode Horiz. Vert. Vert. 
# Posit. W/0 Sp W Sp 

O 40 24 



olors 


Data 


Color 


Memory 




Value 


Reg. 


Reqd. 
(split) <full) 


2 


backgd. 


BAK 


992 992 




00-FF 


PF 2 





PF 1* 



20 24 20 5 backgd. BAK 674 672 

00--3F PF 

40-7F PF 1 

80-BF PF 2 

C0~FF PF 3 

20 12 10 5 backgd. BAK 424 420 



40 24 20 4 O BAK 434 432 



80 48 40 2 BAK 694 696 

1 PF 

80 48 40 4 BAK 1174 1176 



160 96 80 2 BAK 2174 2184 

1 PF O 

160 96 80 4 BAK 4190 4200 



8 320 192 160 2 O PF 2 8112 8138 

1 PF 1* 

9 80 192 -- 1 Note 2 8138 

10 80 192 — 9 PM 8138 



backgd. 


BAK 


00- 


-3F 


PF 


40- 


-7F 


PF 1 


80- 


-BF 


PF 2 


CO- 


-FF 


PF 3 







BAK 


1 




PF 


2 




PF 1 


3 




PF 2 







BAK 


1 




PF 







BAK 


1 




PF 


2 




PF 1 


3 




PF 2 







BAK 


1 




PF 







BAK 


1 




PF 


2 




PF 1 


3 




PF 2 







PF 2 


1 




PF 1* 


Note 2 









PM 


1 




PM 1 


2 




PM 2 


3 




PM 3 


4 




PF 
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11 



80 



192 



16 



5 


PF 1 


6 


PF 2 


7 


PF 3 


8 


BAK 


9 


BAK 


A 


BAK 


B 


BAK 


C 


PF 


D 


PF 1 


E 


PF 2 


F 


PF 3 


Note 3 





8138 



Notes: 

* Uses color of PF 2, lum of PF 1. 

2 Uses color of BAK/ lum of data value (*0-F). 

3 Uses color of data value <*0~F)/ lum of BAK. 



PF X 
PM X 
BAK 



= Playfield color register x. 

= Player/Missile Graphics color register x. 

' Background color register (also known as PF 4). 



The default values for the color registers are shown below: 

BAK = *00 

PFO = *28 

PFl = $CA 

PF2 == *94 

PF3 = *46 
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The form of a color register byte is shown below: 
76543210 

+-+--+--+•--+-+-- 4—+-+ 

{ color 1 lum 101 
4— 4—+~4— +—+—♦— + — t- 



Where: color (hex values) 



lum 






ss 


gray 





ss 


minimum luminance 


1 


35 


light orange 


1 


ss 


1 
1 


2 


= 


orange 


2 


ss 


1 
1 


3 


= 


red orange 


3 


ss 


( increasing 


4 


=: 


pink 


4 


ss 


luminance) 


5 


s: 


purple 


5 


ss 


1 


6 


= 


purple-blue 


6 


= 


1 
1 


7 


= 


b lue 


7 


= 


maximum luminance 


8 


ss 


blue 








9 


ss 


light blue 








A 


ss 


turquoise 








B 


ss 


green-blue 








C 


=; 


green 








D 


ss 


yelloui-green 








E 


ss 


orange-green 








F 


=s 


light orange 
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Appendix I — SERIAL BUS ID AND COMMAND SUMMARY 



Serial bus device IDs 

Floppy diskettes Di~D4 $31-34 

Printer Pi *40 

RS-232~C R1-R4 *50-53 



Serial bus control codes 



ACK 


- *41 


( 'AM 


NAK 


- *4E 


< 'N') 


COMPLETE 


- *43 


( 'O 


ERR 


- *45 


( 'E') 



Serial bus command codes 



READ 


- *52 


( 'R') 


Disk 


WRITE 


- *57 


( 'W') 


Printer/Disk 


STATUS 


- *53 


< 'S') 


Printer/Disk 


PUT(no check) 


- *50 


CP') 


Disk 


FORMAT 


- *21 


< '! ') 


Disk 


READ ADDRESS 


- *54 


< 'T') 




READ SPIN 


- *51 


< 'Q'> 


Disk 


MOTOR ON 


- $55 


( 'U') 


Disk 


VERIFY SECTOR 


- *56 


( 'V') 


Disk 
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Appendix J — ROM VECTORS 



The fixed address OS ROM JMP vectors are shown below; at each 
address is a JMP instruction to the indicated routine. 



Name 



Addr 



Reference Function 



DISKIV 


E450 


* 




DSKINV 


E453 


5. 


4 


CIOV 


E456 


5. 


2 


SIOV 


E459 


9. 


3 


SETVBV 


E45C 


6. 


7 


SYSVBV 


E45F 


6. 


3 


XITVBV 


E462 


6. 


3 


SIOINV 


E465 


» 




SENDEV 


E468 


« 




INTINV 


E46B 


» 




CIOINV 


E46E 


* 




BLKBDV 


E471 


3. 


1 


WARMSV 


E474 


7. 




COLDSV 


E477 


7. 




RBLOKV 


E47A 


» 




CSOPIV 


E47D 


* 





Diskette Handler initialization 

Diskette Handler entry. 

CIO utility entry. 

SIO utility entry. 

Set System Timers routine. 

Stage 1 VBLANK entry. 

Exit VBLANK entry. 

SIO utility initialization. 

Send enable routine. 

Interrupt Handler initialization. 

CIO utility initialization. 

Blackboard mode entry. 

Warmstart ( C SYSTEM. RESET 3 ) entry. 

Coldstart (power-up) entry. 

Cassette-read block entry. 

Cassette-OPEN input entry. 

* These vectors are for OS internal use only. 

The fixed address Floating Point Package ROM routine entry point 
addresses are shown belowi complete descriptions of the 
corresponding routines are provided in Section 8. 

AFP D800 ASCII to FP convert. 

FASC D8E6 FP to ASCII convert. 

IFP D9AA Integer to FP convert. 

FPI D9D2 FP to integer convert. 

FADD DA66 FP add. 

FSUB DA60 FP subtract. 

FMUL DADB FP multiply 

FDIV DB28 FP divide. 

LOG DECD FP base e logarithm. 

LOGIO DEDl FP base 10 logarithm. 

EXP DDCO FP base e exponentiation. 

EXPiO DDCC FP base iO exponentiation. 

PLYEVL DD40 FP polynomial evaluation. 

ZFRO DA44 Clear FRO. 

ZFl DA46 Clear FP number. 

FLDOR DD89 Load FP number. 

FLDOP DD8D Load FP number. 

FLDIR DD98 Load FP number. 

FLDIP DD9C Load FP number. 

FSTOR DDA7 Store FP number. 

FSTOP DDAB Store FP number. 

FMOVE DDB6 Move FP number. 
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The base addresses of the Handler vectors for the resident 
handlers are shoun beloui: 



Screen Editor (E) 
Display Handler (S> 
Keyboard Handler <K) 
Printer Handler (P) 
Cassette Handler (C) 



E400 
E410 
E420 
E430 
E440 



See Section 5 for the format of the entry for each Handler, 

The 6502 Computer interrupt vector values are shouin below: 
Function Address Value 



NMI 


FFFA 


E7B4 


RESET 


FFAC 


E477 


IRQ 


FFFE 


E6FE 
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Appendix K — DEVICE CHARACTERISTICS 



This appendix describes the physical characteristics of the 
devices that interface to the ATARI 400 and ATARI 800 Home 
Computers. Where applicable; data capacity* data transfer 
rate/ storage format/ SIO interface/ and cabling will be 
detailed. 



KEYBOARD 

The keyboard input rate is limited by the OS keyboard reading 
procedure to be 60 characters per second. The code for each key 
is shoun in Table 5-4. The keyboard hardware has no buffering and is 
rate-limited by the debounce algorithm used. 

DISPLAY 

The television screen display generator has many capabilities 
that are not used by the Display Handler (as described in Section 
5 and shown in Appendix H). There are additional display modesi 
object generators/ hardware display scrolling/ and many other 
features that are described in the ATARI Home Computer 
Hardware Manual. 

Since all display data is stored in RAM/ the display data update 
rate is limited primarily by the software routines that generate 
and format the data and access the RAM. The generation of the 
display from the RAM is accomplished by the ANTIC and CTIA or OTIA 
chips using Direct Memory Access (DMA) to access the RAM data. 

The internal storage formats for display data for the various 
modes are detailed in the ATARI Home Computer Hardware 
Manual. 



ATARI 410 PROGRAM RECORDER 

The ATARI 410 Program Recorder has the following characteristics 

DATA CAPACITY: 

100 characters per C-60 tape (unformatted). 
DATA TRANSFER RATES: 

* 600 Baud (60 characters per second) 

*Note: The OS has the ability to adjust to different tape speeds 
(447 - 895 Baud). 
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STORAGE FORMAT: 

Tapes are recorded in 1/4 track stereo format at 1 7/8 inches per 
second. The tape can be recorded in both directions/ tuhere tracks 
i and 2 are side A left and right* and tracks 3 and 4 are side B 
right and left (industry standard). On each side* the left 
channel (1 or 4) is used for audio and the right channel (2 and 
3) is used for digital information. 

The audio channel is recorded the normal u>ay. The digital channel 
is recorded using the POKEY two-tone mode producing FSK data at 
up to 600 baud. The MARK frequency is 5327 Hz and the SPACE 
frequency is 3995 Hz. The transmission of data is asynchronous 
byte serial as seen from the computer; POKEY reads or writes a 
bit serial FSK sequence for each byte* in the following order: 



1 start bit <SPACE) 
data bit O — *• 
data bit 1 ! 

+- = SPACE* 1 = MARK, 
data bit 6 ! 
data bit 7 ~+ 
1 stop bit (MARK) 

The only control the computer has over tape motion is motor 

start/stop; and this only if the PLAY button is pressed by the 

user. In order for recording to take place* the user must press 

both the REC and PLAY buttons on the cassette. The computer has 

no way to sense the position of these buttons* nor even if an 

ATARI 410 Program Recorder is cabled to the computer* so the user must 

be careful when using this device. 

SIO INTERFACE 

The cassette device utilizes portions of the serial bus hardware* 
but does not follow any of the protocol as defined in Section 9. 



ATARI 820CTM3 40~C0LUMN IMPACT PRINTER 

The ATARI 820 Printer has the following characteristics: 

DATA CAPACITY: 

40 characters per line (normal printing) 
29 characters per line (sideways printing) 

DATA TRANSFER RATES: 

OPERATING SYSTEM C016555 — Appendix K 

195 



Bus rate: xx characters per second. 

Print time (burst): xx characters per second. 

Print time (average): xx characters per second 



STORAGE FORMAT: 



3 7/8 inch uide paper. 

5X7 dot matrixi impact printing 



Normal format — 

40 characters per line. 

6 lines per inch (vertical). 

12 characters per inch (horizontal). 



Sideuiays format — 

29 characters per line. 

6 lines per inch (vertical). 

9 characters per inch (horizontal). 



SIO INTERFACE 

The controller serial bus ID is *40. 

The controller supports the following SIO commands (see Section 5 
for more information regarding the Handler and Section 9 for a 
general discussion of bus commands): 

<5ET STATUS 

The computer sends a command frame of the format shown below: 

Device ID = *40. 

Command byte '^ 4>53. 

auxiliary 1 = doesn't matter. 

auxiliary 2 = doesn't matter. 

Checksum » checksum of bytes above. 

The printer controller responds with a data frame of the format 
shown earlier in this appendix as part of the GET STATUS 
discussion. 



PRINT LINE 

The computer sends a command frame of the format shown below: 

Device ID = *40. 
Command byte « *57. 
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auxiliary 1 » doesn't matter. 

auxiliary 2 = *4E for normal print or *53 for sideways. 

Checksum = checksum of bytes above. 

The computer sends a data frame of the format shown below: 

Leftmost character of line (column I). 
Next character of line (column 2). 



Rightmost character of line (column 40 or 29). 
Checksum byte. 

Note that the data frame size is variable/ either 41 or 30 bytes 
in lengthf depending upon the print mode specified in the command 
frame. 



ATARI 810 DISK DRIVE 

The ATARI S10CTM3 Disk Drive has the following characteristics: 

DATA CAPACITY: 

720 sectors of 128 bytes each (Disk Handler format). 

709 sectors of 125 data bytes each (Disk File Manager format) 

DATA TRANSFER RATES: 

Bus rate: 1920 characters per second. 

Seek time: 5. 25 msec, per track •♦■ 10 to 210 msec. 

Rotational latency: 104 msec maximum (288 rpm). 

STORAGE FORMAT: 

5 1/4 inch diskette/ soft sectored by the controller. 
40 tracks per diskette. 
18 sectors per track. 
128 bytes per sector. 

Controlled by National INS1771-1 formatter/controller chip. 
Sector sequence per track is: 18/ 1/ 3/ 5/ 7/ 9, 11/ 13/ 15/ 

17/ 2/ 4/ 6, 8/ 10/ 12/ 14/ 16 

SID INTERFACE 

The controller serial bus IDs range from *31 (for 'Dl') to *34 
(for 'D4'>. 
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The controller supports the following SIO commands (see earlier 
in this Appendix for information about the Diskette Handler and 
Section 9 for a general discussion of bus commands): 



OET STATUS 
The computer sends a command frame of the format shouin belobi: 

Device ID = ♦31-34. 

Command byte = *53. 

auxiliary 1 = doesn't matter. 

auxiliary 2 = doesn't matter. 

Checksum = checksum of bytes above. 

The diskette controller responds with a data frame of the format 
shown earlier in this Appendix as part of the STATUS REQUEST 
discussion. 

PUT SECTOR (WITH VERIFY) 

The computer sends a command frame of the format shown below: 

Device ID = *31-34 

Command byte = *57. 

auxiliary 1 = low byte of sector number. 

auxiliary 2 = high byte of sector number (1-720). 

Checksum = checksum of bytes above. 

The computer sends a data frame of the format shown below: 

128 data bytes. 
Checksum byte. 

The diskette controller writes the frame data to the specified 
sector/ then reads the sector and compares the content with the 
frame data. The COMPLETE byte value indicates the status of the 
operation. 

PUT SECTOR (NO VERIFY) 

The computer sends a command frame of the format shown below: 

Device ID = *31-34 

Command byte = *50. 

auxiliary 1 ~ low byte of sector number. 

auxiliary 2 = high byte of sector number (i-720). 

Checksum = checksum of bytes above. 

The computer sends a data frame of the format shown below: 
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128 data bytes. 
Checksum byte. 

The diskette controller writes the frame data to the specified 
sector* then sends a COMPLETE byte value that indicates the 
status of the operation. 



GET SECTOR 

The computer sends a command frame of the format shown below: 

Device ID * *31-34 

Command byte = $52. 

auxiliary 1 = low byte of sector number. 

auxiliary 2 = high byte of sector number (1-720). 

Checksum = checksum of bytes above. 

The diskette controller sends a data frame of the format shown below: 

128 data bytes. 
Checksum byte. 

FORMAT DISKETTE 

The computer sends a command frame of the format shown below: 

Device ID = *31~34 

Command byte - $21. 

auxiliary i = doesn't matter. 

auxiliary 2 = doesn't matter. 

Checksum ~ checksum of bytes above. 

The diskette controller completely formats the diskette (generates 40 
tracks of 18 soft sectors per track with the data portion of each 
sector eq.ual to all zeros) and then reads each sector to verify 
its integrity. A data frame of 128 bytes plus checksum is 
returned in that the sector numbers of all bad sectors (up to a 
maximum of 63 sectors) are contained/ followed by two consecutive 
bytes of *FF. If there are no bad sectors on the diskette the first 
2 bytes of the data 
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Appendix L — OS DATA BASE VARIABLE FUNCTIONAL DESCRIPTIONS 
CENTRAL DATA BASE DESCRIPTION 



This appendix provides detailed information for those variables 
in the OS data base that can be altered by the user. Remaining 
variables are provided narrative descriptions. Information on the 
variables is presented in a multiple access scheme: Lookup 
tables are referenced to a common set of narrativesi that is 
itself ordered by function. 

Variable descriptions are referenced by a label called a variable 
identifier <VID> number. The label comprises a single letter 
followed by a number. A different letter is assigned for each 
major functional area being described, and the numbers are 
assigned sequentially within each functional area. Those 
variables that are not considered to be of interest to any user 
are flagged with an asterisk (») after their names. The data base 
lookup tables provided are: 

1. Functional grouping — index to the function narrative and 
descriptions of variables^ giving VID and variable name. 

2. Alphabetic list of names — giving VID of description. 

3. Address ordered list — giving VID of description. 

Item 1* the functional grouping index, starts on the next page; 
the other two lookup tables are at the end of Appendix L. 



OPERATING SYSTEM C016555 —Appendix K 
200 



FUNCTIONAL INDEX TO DATA BASE VARIABLE DESCRIPTIONS 



Memory configuration 

Al MEMLO 

A2 MEMTOP 

A3 APPMHI 

A4 RAMTOP 

A5 RAMSIZ 



B. Text/graphics screen 

Cursor control 
Bl CRSINH 
B2 ROWCRS. COLCRS 
B3 OLDROW, OLDCOL 
B4 TXTROW/ TXTCOL 

Screen margins 
B5 LMARGN 
B6 RMARGN 

Color control 

B7 PCOLRO - PC0LR3 
B8 COLORO - C0L0R4 

Text scrolling 
B9 SCRFLG* 

Attract mode 
BIO ATRAC T 
Bll COLRSH* 
B12 DRKMSK* 

Tabb ing 

B13 TABMAP 

Logical text lines 
B14 LOOMAP* 
Bi5 LOOCOL* 

Split screen 
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B16 BOTSCR* 

FILL/DRAW function 
B17 FILDAT 
B18 FILFLQ* 
B19 NEW 5R0W#, NEWCOL* 
B20 H0LD4* 



B21 ROWING*! COLINC* 
B22 DELTAR*, DELTAC* 
B23 COUNTR* 
B24 ROWAC*, COLAC* 
B25 ENDPT* 

Displaying control characters 

Escape (display -Following control char) 
B26 ESCFLG* 

Display control characters mode 
B27 DSPFLG 

Bit mapped graphics 
B28 DMASK« 
B29 SHFAMT* 
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Internal working variables 
B30 HOLDl* 
B31 H0LD2* 
B32 H0LD3* 
B33 TMPCHR* 
B34 DSTAT* 
B35 DINDEX 
B36 SAVMSC 
B37 OLDCHR* 
B38 OLDADR* 
B39 ADRESS* 

B40 MLTTMP/OPNTMP/TOADR* 
B41 SAVADR/FRMADR* 
B42 BUFCNT* 
B43 BUFSTR* 
B44 SWPFLG* 
B45 INSDAT* 
B46 TMPROW*/ TMPCOL* 
B47 TMPLBT* 
B48 SUBTMP* 
B49 TINDEX* 
B50 BITMSK* 
B51 LINBUF* 
B52 TXTMSC 
B53 TXTOLD* 
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Internal character code conversion 
B54 ATACHR 
B55 CHAR* 



Disk Handler 
CI BUFADR* 
C2 DSKTIM* 



Cassette (part in SIO part in Handler) 

Baud rate determination 
Dl CBAUDL*, CBAUDH* 
D2 TIMFLG* 
D3 TIMER 1*1 TIMER2* 
D4 ADDCOR* 
D5 TEMPI* 
D6 TEMPS* 
D7 SAVIO* 

Cassette mode 
D8 CASFLO* 

Cassette buffer 
D9 CASBUF* 
DIO BLIM* 
Dll BPTR* 

Internal working variables 
D12 FEOF* 
D13 FTYPE* 
D14 WMODE* 
D15 FREQ* 



E. Keyboard 

Key reading and debouncing 
El CHI* 
E2 KEYDEL* 
E3 CH 
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Special functions 

Start/stop 
E4 SSFLAO 

£ BREAK 3 
E5 BRKKEY 

CSHIFT3/CCONTROL3 lock 
E6 SHFLOK 
E7 HOLDCH* 

Autorepeat 
E8 SRTIMR* 

Inverse video 
E9 INVFLO 

Console switches (CSELECT3, CSTART3, and C0PTI0N3 > 



F. Printer 

printer-buffer 

Fl PRNBUF* 
F2 PBUFSZ* 
F3 PBPNT* 

Internal working variables 
F4 PTEMP* 
F5 PTIMOT* 

Q. Central I/O routine (CIO> 

User call parameters 

01 lOCB 

G2 ICHID 

03 ICDNO 

04 ICCOM 

05 ICSTA 

06 ICBALr ICBAH 

07 ICPTL, ICPTH 

08 ICBLL, ICBLH 

09 ICAXl, ICAX2 

010 ICSPR 

Device status 
Oil DVSTAT 

device table 
012 HATABS 
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CIO/Handler interface Parameters 

G13 ZIOCB (lOCBAS) 

G14 ICHIDZ 

G15 ICDNOZ 

G16 ICCOMZ 

G17 ICSTAZ 

G18 ICBALZ, ICBALH 

G19 ICPTLZ/ ICPTHZ 

G20 ICBLLZ/ ICBLHZ 

G21 ICAXIZ* ICAX2Z 

G22 ICSPRZ (ICIDNO, CIOCHR) 

Internal working variables 
G23 ICCOMT* 
G24 ICIDNO* 
G25 CIOCHR* 



H. Serial I/O routine (SIO) 



User call parameters 

HI DCB control block 
H2 DDEVIC 
H3 DUN IT 
H4 DCOMND 
H5 DSTATS 
H6 DBUFLO, DBUFHI 
H7 DTIMLO 
H8 DBYTLO, DBYTHI 
H9 DAUXi.DAUX2 

Bus sound control 
HIO SOUNDR 

Serial bus control 

Retry logic 
Hll CRETRY* 
H12 DRETRY* 

Checksum 

H13 CHKSUM* 
H14 CHKSNT* 
HI 5 NOCKSM* 
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Data buffering 

General buffer control 

H16 BUFRLO*,BUFRHI* 
Hi7 BFENLO*, BFENHI* 

Command frame output buffer 
H18 CDEVIC* 
H19 CCOMND* 
H20 CAUXi*,CAUX2* 

Receive/transmit data buffering 
H21 BUFRFL* 
H22 RECVDN* 
H23 TEMP* 
H24 XMTDON* 

SIO timeout 
H25 TIMFLG* 
H26 CDTMVl* 
H27 CDTMAl* 

Internal working variables 
H28 STACKP* 
H29 TSTAT* 
H30 ERRFLG* 
H31 STATUS* 
H32 SSKCTL* 

J. ATARI controllers 

Joysticks 

Jl STICKO - STICKS 
J2 STRIOO - STRIG3 

Paddles 

J3 PADDLO - PADDL7 
J4 PTRIGO - PTRIG7 

Paddle controllers 
J8 STICKO - STICK3 
J9 STRIGO - STRIG3 



K. Disk file manager 
Kl FMSZPG* 
K2 ZBUFP* 
K3 ZDRVA* 
K4 ZSBA* 
K5 ERRNO* 
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Disk utilities (DOS) 
Li DSKUTL* 



M. Floating point package 
Ml FRO 
M2 FRE* 
M3 FRl 
M4 FR2* 
M5 FRX* 
M6 EEXP* 
M7 NSIGN* 
M8 ESI ON* 
M9 FCHRFLG* 
MIO DIORT* 
Mil CIX 
Ml 2 INBUFF 
M13 ZTEMPl* 
M14 ZTEMP4* 
Ml 5 ZTEMP3* 
M16 FLPTR 
Ml 7 FPTR2* 
M18 LBPRl* 
Ml 9 LBPR2* 
M20 LBUFF 
M21 PLYARG* 
M22 FPSCR/FSCR* 
M23 FPSCRl/FSCRl* 
M24 DEGFLG/RADFLQ* 



N. Pouier~Up and System Reset 
RAM sizing 

Nl RAMLO*. TRAMSZ* 
N2 TSTDAT* 



Diskette/cassette-boot 
N3 DOSINI 
N4 CKEY* 
N5 CASSBT* 
N6 CASINI 
N7 BOOT?* 
N8 DFLAGS* 
N9 DBSECT* 
NIO BOOT AD* 

Environmental control 
Nil COLDST 
N12 DOSVEC 
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CS RESET 3 

N13 WARMST 



Interrupts 
PI CRITIC 
P2 PQKMSK 

System Timers 

Real-time clock 
P3 RTCLOK 

System Timer 1 
P4 CDTMVl 
P5 CDTMAl 

System Timer 2 
P6 CDTMV2 
P7 CDTMA2 

System Timers 3-5 

P8 CDTMV3, CDTMV4, CDTMV5 
P9 CDTMFSi CDTMF4, CDTMF5 

RAM-interrupt vectors 

Nlil-interrupt vectors 
PIO VDSLST 
Pll WBLKI 
P12 VVBLKD 



IRQ-interrupt vectors 
P13 VIMIRQ 
P14 VPRCED 
P15 VINTER 
P16 VBREAK 
P17 VKEYBD 
PIS VSERIN 
Pi9 VSEROR 
P20 VSEROC 
P21 VTIMRl, VTIMR2, VTIMR4 

Hardware register updates 
P22 SDMCTL 
P23 SDLSTL, SDLSTH 
P24 OPRIOR 
P25 CHACT 
P26 CHBAS 
P27 PCOLRx, COLOR X 
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Internal working variable 
P28 INTEMP* 



User areas 

Ri (unlabeled) 

R2 USAREA 



This appendix contains descriptions of many of the data base 
variablesi descriptions are included for all of the user- 
accessible variables and for some of the "internal" variables as 
well. Those variables that are not considered to be normally of 
interest to any user are flagged with an asterisk (*) after their 
names; the other variables can be of interest to one or more of 
the following classes of users: 



o End user. 

o Game developer. 

o Applications programmer. 

o System utility writer. 

o Language processor developer 

o Device Handler Writer. 



Each variable is specified by its system equate file name 
followed by its address (in hex) and the number of bytes reserved 
in the data base (in decimal)/ in the following form: 

<name> C<address>/ <size>3 

For example: 

MEMLO C02E7, 23 

Note that most word (2 byte) variables are ordered with the least 
significant byte at the lower address. 
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A. MEMORY CONFIGURATION 

See Section 4 for a general discussion of memory dynamics and 
section 7 for details of system initialization. 

Al MEMLO C02E7,23 — User-free memory low address 

MEMLO contains the address of the first location in the free 
memory region. The value is established by the OS during pouier-up 
and system reset initialization and is never altered by the OS 
thereafter. 



A2 MEMTOP C02E5/ 23 — User-free memory high address 

MEMTOP contains the address of the first non-useable memory 
location above the free memory region. The value is established 
by the OS during pouier-up and system reset initialization; and 
then is re-established whenever the display is opened> based upon 
the recLuirements of the selected graphics mode. 

A3 APPMHI COOOE/ 23 — - User-free memory screen lower limit 

APPMHI is a user-controlled variable that contains the address 
within the free memory region below which the Display Handler cannot 
go in setting up a display screen. This variable is 
initialized to zero by the OS at power-up. 

A4 RAMTOP* COO6A1I3 — Display Handler top of RAM address <MSB) 

RAMTOP permanently retains the RAM top address that was contained 
in TRAMSZ (as described in Nl ) for the Display Handler's use. The 
value is set up as part of Handler initialization. 

A5 RAMSIZ C02E4. 13 — Top of RAM address (MSB only) 

RAMSIZ permanently retains the RAM top address that was contained 
in TRAMSZ (as described in Nl). 
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B. TEXT/GRAPHICS SCREEN 

discussion of the text and graphics screens 



See 
and 



Section 5 for a 
their Handlers. 



Cursor Control 

For the text screen and split-screen text window there is a 
visible cursor on the screen which shows the position of the next 
input or output operation. The cursor is represented by inversing 
the video of the character upon which it residesi but the cursor 
can be made invisible* at the user's option. The graphics screen 
always has an invisible cursor. 

The cursor position is sensed by examining data base variables 
and can be moved by altering those same variables; in addition* 
when using the Screen Editor* there are cursor movement control 
codes that can be sent as data (as explained in Section 5). 



Bl CRSINH C02F0* 13 



Cursor display inhibit flag 



When CRSINH is zero* all outputs to the text screen will be 
followed by a visible cursor (inversed character); and when 
CRSINH is nonzero* no visible cursor will be generated. 

CRSINH is set to zero by power~up* the C SYSTEM. RESET 3 or CBREAK3 keys 
or an OPEN command to the Display Handler or Screen Editor. 

Note that altering CRSINH does not cause the visible cursor to 
change states until the next output to the screen; if an 
immediate change to the cursor state is desired* without altering 
the screen data* follow the CRSINH change with the output of 
CURSOR UP, CURSOR DOWN* or some other innocuous sequence. 



B2 ROWCRS C0054*13 and COLCRS C0055* 23 — Current cursor 
position 

ROWCRS and COLCRS define the cursor location (row and column* 
respectively) for the next data element to be read from or 
written to the main screen segment. When in split-screen mode* 
the variables TXTROW and TXTCOL define the cursor for the text 
window at the bottom of the screen as explained in B4 below. 

The row and column numbering start with the value zero* and 
increase in increments of one to the number of rows or columns minus 
1* with the upper left corner of the screen being the origin (0*0). 

ROWCRS is a single-byte variable with a maximum allowable value 
of 191 (screen modes 8-11); COLCRS is a 2-byte variable with a 
maximum allowable value of 319 (screen mode 8). 
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B3 OLDROW COOSA, 13 and OLDCOL C005B, 23 -— Prior cursor position 

OLDROW and OLDCOL are updated from ROWCRS and COLORS before every 
operation. The variables are used only for the DRAW and FILL 
operations. 

B4 TXTROW C0290, 13 and TXTCOL C0291.23 — Split-screen text cursor 
position 

TXTROW and TXTCOL define the cursor location (row and columnr 
respectively) for the next data element to be veadi from or 
written to the split-screen text window. 

The row and column numbering start with the value zero, and 
increase in increments of one to 3 and 39# respectively; with the 
upper left corner of the split-screen text window being the origin 
(0,0). 



Screen Margins 

The text screen and split-screen text window have user-alterable 
left and right margins that define the normal domain of the text 
cursor. 



B5 LMARGN C0052il3 — Text column left margin 

LliARGN contains the column number (0-39) of the text screen left 
margin; the text cursor will remain on or to the right of the 
left margin as a result of all operations, unless the cursor 
column variable is directly updated by the user (see B2 and B4 
above). The default value for LliARGN is 2 and is established upon 
power-up or system reset. 

B6 RMARGN C0053/13 — Text column right margin 

RMARGN contains the column number (0-39) of the text screen right 
margin; the text cursor will remain on or to the left of the 
right margin as a result of all operations, unless the cursor 
column variable is directly updated by the user (see B2 and B4 
above). The default value for RMARGN is 39 and is established 
upon power-up or system reset. 
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Color Control 

As part of the stage 2 VBLANK process (see Section 6> > the values of 
nine data base variables are stored in corresponding hartiutare 
color control registers. The color registers are divided into two 
groups: the player/missile colors and the playfield colors. The 
playfield color registers are utilized by the different screen modes 
as shown in Appendix H. The player/missile color registers are not 
used by the standard OS. 

B7 PCOLRO - PC0LR3 C02C0, 43 — Player/missile graphics colors 

Each color variable is stored in the corresponding hardware 
register as shown below: 

PCOLRO C02C03 COLPMO CD0123 

PCOLRl C02C13 COLPMl CD0133 

PC0LR2 C02C23 C0LPM2 CD0143 

PC0LR3 C:02C33 C0LPM3 CD0153 

Each color variable has the format shown below: 

7 6 5 4 3 2 10 

4— +—♦—+—♦•— +~+—+-4- 

I color ! lum 'x! 
4— +-+-+— ♦—f~+—*— •+ 

See Appendix H for information regarding the color and luminance 
field values. 

B8 COLORO - C0L0R4 C02C5, 53 — Playfield colors 

Each color variable is stored in the corresponding hardware 
register as shown below: 

COLORO C02C43 COLPFO CD0163 

COLORl C02C53 COLPFl CDOi73 

C0L0R2 C02C63 C0LPF2 [:D0183 

C0L0R3 C02C73 C0LPF3 CD0193 

C0L0R4 C02C83 COLBK CD01A3 

Each color variable has the format shown below: 

76543210 

I color { lum 'xl 
4— +—♦■•— *•—+-+— ♦—♦—+ 

See Appendix H for information regarding the color and luminance 
field values. 
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Text Scrolling 

The text screen or split-screen text window "scrolls" upward 
whenever one of the two conditions shown below occurs: 

o A text line at the bottom row of the screen extends past the 
right margin. 

o A text line at the bottom row of the screen is terminated by 
an EOL. 

Scrolling has the effect of removing the entire logical line that 
starts at the top of the screen and then moving all subseqtuent 
lines upward to fill in the void. The cursor will also move 
upward if the logical line deleted exceeds one physical line. 



B9 SCRFLG* C02BB, 13 -- Scroll flag 

SCRFLG is a working variable that counts the number of physical 
lines minus 1 that were deleted from the top of the screen; 
since a logical line ranges in size from 1 to 3/ SCRFLG ranges 
from O to 2. 



Attract Mode 

Attract mode is a mechanism that protects the television screen 
from having patterns "burned into" the phosphors iiue to a fixed 
display being left on the screen for extended periods of time. 
When the computer is left unattended for more than 9 minutes^ the 
color intensities are limited to 50 percent of maximum and the 
hues are continually varied every 8.3 seconds. Pressing any 
keyboard data key will be sufficient to remove the attract mode 
for 9 more minutes. 

As part of the stage 2 VBLANK process* the color registers from 

the data base are sent to the corresponding hardware color 

registers; before they Bve sent* they undergo the following 
transformation: 

hardware register = database variable XOR COLRSH AND DRKMSK 

Normally COLRSH = *00 and DRKMSK = *FE# thus making the above 
calculation a null operation; however* once attract mode becomes 
active* COLRSH = the content of RTCLOK+1 and DRKMSK = *F6* that 
has the effect of modifying all of the colors and keeping their 
luminance always below the 50 percent level. 

Since RTCLOK+1 is incremented every 256/60 of a second and 

since the least significant bit of COLRSH is of no consequence* a 
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color/lum change will be effected every 8.3 seconds <5i2/60). 

BIO ATRACT C004Din — Attract mode timer and flag 

ATRACT is the timer (and flag) that controls the initiation and 
termination of attract mode. Whenever a keyboard key is pressedi 
the keyboard IRQ service routine sets ATRACT to zero* thus 
terminating attract mode; the CBREAK3 key logic behaves 
accordingly. As part of the stage 1 VBLANK process, ATRACT is 
incremented every 4 seconds; if the value exceeds 127 (after 9 
minutes without keyboard activity), the value of ATRACT will 
be set to *FE and will retain that value until attract mode is 
terminated. 

Since the attract mode is prevented and terminated by the OS 
based only upon keyboard activity, some users can want to reset 
ATRACT based upon Atari-controller event detection, 
user-controlled Serial I/O bus activity or any other signs of 
life. 



Bll COLRSH* C004F, 13 — Color shift mask 

COLRSH has the value $00 when attract mode is inactive, thus 
effecting no change to the screen colors; when attract mode is 
active, COLRSH contains the current value of the timer variable 
middle digit (RTCLOK+l). 

B12 DRKMSK* C004E, 13 — Dark (luminance) mask 

DRKIiSK has the value $FE when attract mode is inactive, which does not 
alter the luminance; and has the value 4»F6 when attract mode 
is active, which forces the most significant bit of the luminance 
field to zero, thus guaranteeing that the luminance will never 
exceed 50 percent. 



Tabbing 

See Section 5 for a discussion of the use of tabs in conjunction 
with the Screen Editor. 



B13 TABMAP C02A3, 153 — Tab stop setting map 

The tab settings are retained in a 15-byte (120 bit) map, where a 
bit value of 1 indicates a tab setting; the diagram below shows 
the mapping of the individual bits to tab positions. 
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7 6 5 4 3 2 10 

4- + + + -¥ -f + + + 

J O .' 1 { 2 { 3 I 4 .' 5 J 6 { 7 .' 

+ + + + + + ^. + + 

{ 8 I 9 { 101 115 125 13} 14J 151 

+ + ^ 4. 4. 4.^ — 4. 4. 4. 

\ \ 

I i 

4. 4. 4. 4. 4. 4. 4. 4. 4. 

'.112 11 13 1 114 1 115 {116 1 117 11 18 {119 1 
4. 4. 4. 4. 4. 4. 4. 4. 4. 



TABMAP+0 



+1 



+ 14 



Whenever the Display Handler or Screen Editor is opened« this map 
is initialized to contain the value of $01 in every byte# thus 
providing the default tab stops at 7# 15i 23/ etc. 



Logical Text Lines 

The text screen is invisibly divided into logical lines of text* 
each comprising from one to three physical lines of text. The 
screen is initialized to 24 logical lines of one physical line 
each; but data entry and/or data insertion can increase the size 
of a logical line to two or three physical lines. 

B14 LOGMAP* C02B2# 43 — Logical line starting row map 

The beginning physical line number for each logical line on the 
screen is retained in a four byte (32 bit) map/ where a bit value 
of one indicates the start of a logical line; the diagram below 
shows the mapping of the individual bits to physical line (row) 
numbers. 



7 6 5 4 3 2 10 

4. >. 4. 4. 4- 4. 4. 4. 4. 

{ 0{ 1{ 2{ 31 4{ 5! 6{ 7 



{ 8} 9{10{11{12{13}14}15 
+ — + — + — •+• — + — + — + — + — 
{16 {17 {18 1 19 1 20 1 21 I 22 {23 



LOQMAP+0 
+ 1 
+2 
-»-3 



The map bits are all set to 1 whenever the text screen is 

opened or cleared. From that point* the map is updated as 

logical lines are entered, edited and deleted from the screen. 
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B15 LOGCOL* C0063#13 — Cursor/logical line column number 

LOOCQL contains the logical-line column number for the current 
cursor position; note that a logical line can comprise up to 
three physical lines. This variable is for the internal use o-P 
the Display Handler. 



Split Screen 

The Display Handler and Screen Editor together support the 
operation of a split-screen mode (see Section 5) in uihich the main 
portion of the screen is in one of the graphics modes and is 
controlled by the Display Handler^ and there are 4 physical lines in 
the text window at the bottom of the screen which is controlled by the 
Screen Editor. 



B16 BOTSCR* C02BF, 13 



Text screen lines count 



BOTSCR contains the number of lines of text for the current 
screen: 24 for mode O or 4 for a split-screen mode. The Handler 
also uses this variable as an indication of the split-screen 
statusi tests are made for the specific values 4 and 24. 



DRAW/FILL Function 

The DRAW function line drawing algorithm is shown below 
translated to the PASCAL language from assembly language. 



NEWROW := ROWCRSi NEWCOL 



DELTAR := ABS ( NEWROW-OLDROW ) i 

ROWINC :« SIGN (NEWROW-OLDROW) 

DELTAC := ABS (NEWCOL-OLDCOL); 

COLXNC := SIGN (NEWCOL-OLDCOL) 



COLCRS; 

< +1 or -1 > 

< +1 or -1 > 



ROWAC : = 0, COLAC : = 0; 

ROWCRS := OLDROW; COLCRS := OLDCOL; 

COUNTR := MAX ( DELTAC / DELTAR ) ; 

ENDPT := COUNTRi 

IF COUNTR = DELTAC 

THEN ROWAC := ENDPT DIV 2 
ELSE COLAC := ENDPT DIV 2; 

WHILE COUNTR > DO 
BEGIN 
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ROWAC := ROWAC + DELTAR; 
IF ROWAC >= ENDPT 
THEN 

BEGIN 

ROWAC : = ROWAC - ENDPT; 
ROWCRS : = ROWCRS ■»■ ROWINC 
ENOi 

COLAC := COLAC + DELTAC; 
IF COLAC >= ENDPT 
THEN 

BEGIN 

COLAC := COLAC - ENDPT; 
COLCRS := COLCRS + COLINC 
END; 

PLOT_POINT; < point defined by ROWCRS and COLCRS > 

IF FILFLG O O THEN FILL_LINE; 

COUNTR := COUNTR - 1 

END; 

The FILL function algorithm (FILL_LINE above) is described briefly in 
Section 5. 



B17 FILDAT C02FD/13 -- Fill data 

FILLDAT contains the fill region data value as part of the calling 
sequence for a FILL command as described in Section 5. 



B18 FILFLG* C02B7, 13 — - Fill flag 

FILFLG indicates to the shared code within the Display Handler 
whether the current operation is FILL <FILFLG O 0> or DRAW 
(FILFLG = 0). 



B19 NEWROW» £0060/13 and NEWCOL* E0061/23 — Destination point 

NEWROW and NEWCOL are initialized to the values in ROWCRS and 
COLCRS* which represent the destination endpoint of the DRAW/FILL 
command. This is done so that ROWCRS and COLCRS can be altered 
during the performance of the command. 

B20 H0LD4* C:02BC# 13 — Temporary storage 
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H0LD4 is used to save and restore the value in ATACHR during the 
FILL process; ATACHR is temporarily set to the value in FILDAT to 
accomplish the filling portion of the command. 

B21 ROWING* C0079, 13 and COLINC* C007A, 13 — Row/column 
increment /decrement 

ROWING and GOLING are the row and column increment values; they 
are each set to 4-1 or ~1 to control the basic direction of line 
drawing. ROWING and GOLING represent the signs of NEWROW -- 
ROWGRS and NEWGOL - GOLGRS/ respectively. 

B22 DELTAR» C0076, 13 and DELTAC* C0077i 23 — Delta row and delta 
column 

DELTAR and DELTAG contain the absolute values of NEWROW - ROWGRS 
and NEWGOL - GOLGRS/ respectively; together with ROWING and 
GOLING/ they define the slope of the line to be drawn. 

B23 GOUNTR* C007E/ 23 — Draw iteration count 

GOUNTR initially contains the larger of DELTAR and DELTAG/ that 
is the number of iterations required to generate the desired 
line. GOUNTR is then decremented after every point on the line is 
plotted/ until it reaches a value of zero. 

B24 ROWAG* C 0070/ 23 and GOLAG* E 0072/ 23 — Accumulators 

ROWAG and GOLAG are working accumulators that control the row-and 
column-point plotting and increment (or decrement) function. 

B25 ENDPT» C0074/ 23 — Line length 

ENDPT contains the larger of DELTAR and DELTAG/ and is used in 
conjunction with ROWAG/GOLAG and DELTAR/DELTAG to control the 
plotting of line points. 



Displaying Gontrol Characters 

Often it is useful to have ATASGII control codes <such as GLEAR/ 
CURSOR UP/ etc), displayed in their graphic forms instead of 
having them perform their control function. This display 
capability is provided in two forms when outputting to the Screen 
Editor: 1) a data content form in which a special character (ESC) 
precedes each control character to be displayed and 2) a mode 
control form. 
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Escape (Display Following Control Character) 

Whenever an ESC character is detected by the Screen Editor/ the 
next character following this code is displayed as 4ata, even if 
it would normally be treated as a control code; the EOL code is 
the sole exception. It is always treated as a control code. The 
sequence ESC ESC will cause the second ESC character to be 
displayed. 

B26 ESCFLG* C02A2, 13 -— Escape flag 

ESCFLQ is used by the Screen Editor to control the escape 
sequence function; the flag is set (to *80) by the detection of 
an ESC character (*1B> in the data stream and is reset (to O) 
following the output of the next character. 



Display Control Characters Mode 

When it is desired to display ATASCII control codes other than 
EOL in their graphics form/ but not have an ESC character 
associated with each control codei a display mode can be 
established by setting a flag in the data base. This capability 
is used by language processors when displaying high-level 
language statements/ that can contain control codes as data 
elements. 



B27 DSPFLO C02FE/13 — Display control characters flag 

When DSPFLO is nonzero/ ATASCII control codes other than EOL are 
treated as data and displayed on the screen when output to the 
Screen Editor. When DSPFLO is zero/ ATASCII control codes are 
processed normally. 

DSPFLO is set to zero by Power-up and C SYSTEM. RESET 3. 



Bit-Mapped Graphics 

A number of temporary variables are used by the Display Handler 
when handling data elements (pixels) going to or from the screen; 
of interest here are those variables that are used to control the 
packing and unpacking of graphics data/ where a memory byte 
typically contains more than one data element (for example/ 
screen mode 8 contains 8 pixels per memory byte). 

B28 DMASK* C02A0/ 13 — Pixel location mask 
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DMASK is a mask that contains zeros for all bits that do not 
correspond to the specific pixel to be operated upon* and 
I's for all bits that do correspond. DMASK can contain 
the values shown below in binary notation: 

lillllll — screen modes 1 and 2; one pixel per byte. 

illlOOOO — screen modes 9-11/ two pixels per byte. 
00001111 

11000000 — screen modes 3/ 5 and 7; four pixels per byte. 

00110000 

00001100 

00000011 

10000000 — screen modes 4# 6 and 8« eight pixels per byte, 
01000000 

00000010 
00000001 



B29 SHFAMT* C006F, 13 — Pixel justification 

SHFAMT indicates the amount to shift the right-justified pixel 
data on outputs or the amount to shift the input data to right 
justify it on input. The value is always the same as for DMASK 
prior to the justification process. 



Internal Working Variables 

B30 HOLDl* C0051/13 — Temporary storage 

B31 H0LD2» C029Fil3 — Temporary storage 

B32 H0LD3* C029D/13 — Temporary storage 

B33 TMPCHR* C0050»13 — Temporary storage 

B34 DSTAT* C004C, 13 — Display status 

B35 DINDEX C0057, 13 -- Display mode 

DINDEX contains the current screen mode obtained from the low 
order four bits of the most recent OPEN AUXl byte. 

B36 SAVMSC C0058i 23 — Screen Memory Address 

SAVMSC contains the lowest address of the screen data regipni the 
data at that address is displayed at the upper left corner of the 
screen. 
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B37 OLDCHR* COOSDin — Cursor character save/restore 

OLDCHR retains the value of the character under the visible text 
cursor; this variable is used to restore the original character 
value when the cursor is moved. 



B38 OLDADR* C005E/ 23 — Cursor memory address 

OLDADR retains the memory address of the current visible text 
cursor location; this variable is used in conjunction with OLDCHR 
(B37) to restore the original character value when the cursor is 
moved. 



B39 ADRESS* C 0064* 23 — Temporary storage 

B40 MLTTMP/OPNTMP/TOADR* C 0066, 23 — Temporary storage 

B41 SAVADR/FRMADR* COO681 23 — Temporary storage 

B42 BUFCNT» C:006Bi 13 — Screen Editor current logical line size 

B43 BUFSTR* C006C* 23 — Temporary storage 

B44 SWPFLG* C007B/13 — Split-screen cursor control 

In split-screen mode< the graphics cursor data and the text 
window cursor data are frequently swapped as shown below in order 
to get the variables associated with the region being accessed 
into the ROWCRS-OLDADR variables. 

ROWCRS B2 TXTROW B4 

COLCRS B2 TXTCOL B4 

DINDEX B35 TINDEX B49 

SAVMSC B36 TXTMSC B52 

OLDROW B3 TXTOLD B53 

OLDCOL B3 

OLDCHR B37 

OLDADR B38 — 

SWPFLO is used to keep track of what data set is currently in the 
ROWCRS-OLDADR region; SWPFLG is equal to *FF when split-screen 
text window cursor data is in the main region* otherwise SWPFLG 
is equal to 0. 

B45 INSDAT* C007D#13 — Temporary storage 
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B46 TMPROW* C02B8, 13 and TMPCOL* C02B9, 23 — Temporary storage 
B47 TMPLBT* C02Alii3 — Temporary storage 
B48 SUBTMP* C029E/13 — Temporary storage 

B49 TINDEX* C0293# i3 — Split screen text window screen mode 

TINDEX is the split-screen text window equivalent of DINDEX and is 
always equal to zero when SWPFLO is equal to zero (see B44). 

B50 BITMSK* C006Eil3 — Temporary storage 

B51 LINBUF* C0247, 403 — Physical line buffer 

LINBUF is used to temporarily buffer one physical line of text 
when the Screen Editor is moving screen data. 

B52 TXTMSC C0294» 23 — Split screen memory address 

TXTMSC is the split-screen text window version of SAVMSC (B36). 

See B44 for more information. 

B53 TXTOLD* C0296i 63 — Split screen cursor data 
See B44 for more information. 

Internal Character Code Conversion 

Two variables are used to retain the current character being 
processed (for both reading and writing); ATACHR contains the 
value passed to or from CIO« and CHAR contains the internal code 
corresponding to the value in ATACHR. Because the hardware does 
not interpret ATASCII characters directly* the transformations 
shown below are applied to all text data read and written: 

ATASCII INTERNAL 

CODE CODE 

00- IF 40- 5F 

20-3F 00- IF 

40-5F 20-3F 

60-7F 60-7F 

80-9F CO-DF 
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AO-BF 80~9F 

CO-DF AO~BF 

EO-FF EO-FF 

See P26 for more information. 



B54 ATACHR C02FBil3 — Last ATASCII character or plot point 

ATACHR contains the ATASCII value for the most recent character 
read or writteni or the value of the graphics point. This 
variable can also be considered to be a parameter of the 
FILL/DRAW commands^ as the value in ATACHR ttfill determine the 
line color when a DRAW or FILL is performed. 

B5S CHAR* C02FA/ 13 — Internal character code 

CHAR contains the internal code value for the most recent 
character read or written. 



C. DISKETTE HANDLER 

See Section 5 for a discussion of the resident Diskette Handler. 

CI BUFADR* C0015/23 — Data buffer pointer 

BUFADR acts as temporary page zero pointer to the current 
diskette buffer. 

C2 DSKTIM* {!0246^«13 — Disk format operation timeout time 

DSKTIli contains the timeout value for SIO calling sequence 
variable DTIMLO (see Section 9). DSKTIM is set to 160 (which 
represents a 171-second timeout) at initialization time^ and is 
updated after each diskette status request operation. It contains the 
value returned in the third byte of the status frame (see Section 
5). Note that all diskette operations other than format have a 
fixed (7) second timeoutt established by the Diskette Handler. 



D. CASSETTE 

See Section 5 for a general description of the Cassette Handler. The 
cassette uses the Serial I/O bus hardwarei but does not conform with 
the Serial I/O bus protocol as defined in Section 9. Hencei the Serial 
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I/O utility <SIO) has cassette specific code uiithin it. Some variables 
in this subsection are utilized by SIO and some by the Cassette 
Handler. 



Baud Rate Determination 

The input h^ud rate is assumed to be a nominal 600 baudi but uiill 
be adjusted/ if necessary^ by the SIO routine to account for 
drive-motor variations/ stretched tape/ etc. The beginning of 
every cassette record contains a pattern of alternating 1 's and 
zeros that is used solely for speed correction; by measuring the 
time to read a fixed number of bitS/ the true-receive baud rate 
is determined and the hardware adjusted accordingly. Input baud 
rates ranging from 318 to 1407 baud can theoretically be handled 
using this technique. 

The input baud rate is adjusted by setting the POKEY counter that 
controls the bit sampling period. 

m CBAUDL* C02EE/ n and CBAUDH* Z02EF, 11 — - Cassette baud rate 

Initialized to 05CC hexi which represents a nominal 600 baud. 
After baud rate calculation/ these variables will contain POKEY 
counter values for the corrected baud rate. 



D2 TIMFLG* C0317/ 13 — Baud rate determination timeout flag 

TIMFLG is used by SIO to timeout an unsuccessful baud rate 
determination. The flag is initially set to 1/ and if it attains a 
value of zero (after 2 seconds) before the first byte of the cassette 
record has been readi the operation will be aborted. See also H24. 

D3 TIMERl* C030C/23 and TIMER2* C0310/ 23 — - Baud rate timers 

These timers contain reference times for the beginning and end of 
the fixed bit pattern receive period. The first byte of each 
timer contains the then current vertical line counter value read 
from ANTIC/ and the second byte of each timer contains the then 
current value of the least significant byte of the OS real time 
clock (RTCL0K+2>. 

The difference between the timers is converted to raster pair 
counts and is then used to perform a table lookup with 
interpolation to determine the new values for CBAUDL and CBAUDH. 



D4 ADDCOR» C030E/13 — Interpolation adjustment variable 
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ADDCOR is a temporary variable used for the interpolation 
calculation of the above computation. 

D5 TEMPI* C0312i 23 — Temporary storage 

D6 TEMP3* C0315#13 — Temporary storage 

D7 SAVIO* i:03i6i 13 — Serial in data detect 

SAVIO is used to retain the state of SKSTAT C:D20F3 bit 4 (serial 
data in); it is used to detect (and is updated after) every bit 
arrival. 

Cassette Mode 

D8 CASFLO* C030F, 13 — Cassette I/O flag 

CASFLG is used internally by SIO to control the program flow 
through shared code. A value of zero indicates that the current 
operation is a standard Serial I/O bus operation^ and a nonzero 
value indicates a cassette operation. 

Cassette Buffer 

D9 CASBUF* C03FDil313 -- Cassette record buffer 

CASBUF is the buffer used by the Cassette Handler for the packing 
and unpacking of cassette-record data^ and by the initialization 
cassette-boot logic. The format for the standard cassette record 
in the buffer is shown beloui: 

7 6543210 

4—4— +-+—*■— +--4—4—+ 

{OIOIOIOIJ CASBUF4.0 

4— 4— 4— 4— 4— 4— 4—4— 4- 

JO 1 1 O 1 IJ -n 

4— 4— 4— 4— 4— 4— 4— 4— 4* 

} control byte 5 +2 

\ 128 I -^3 

ss data = 

I bytes i +130 

See Section 5 for an explanation of the standard cassette-record 
format. 

OPERATING SYSTEM C016555 — Appendix L 

227 



DIO BLIM» C:028A, 11 — Cassette record data size 

BLIM contains the count of the number of data bytes in the 
current cassette record being read. BLIM will have a value 
ranging from 1 to 128» depending upon the record control byte as 
explained in Section 5. 

Dll BPTR* C003D. 13 — Cassette-record data index 

BPTR contains an index into the data portion of the cassette 
record being read or written. The value will range from to the 
then current value of BLIM. When BPTR equals BLIM then the buffer 
(CASBUF) is full if writing or empty if reading. 



Internal Working Variables 

D12 FEOF* C003F, 13 — Cassette end~of~file flag 

FEOF is used by the Cassette Handler to flag the detection of an 
end of file condition (control byte = *FE). FEOF equal to zero 
indicates that an EOF has not yet been detected/ and a nonzero 
value indicates that an EOF has been detected. The flag is reset 
at every OPEN. 

D13 FTYPE* C003E/13 — Interrecord gap type 

FTYPE is a copy of ICAX2Z from the OPEN command and indicates the 
type of interrecord gap selected; a positive value indicates 
normal record gapsi and a negative value indicates continuous 
mode gaps. 



D14 WMODE* C0289/13 — Cassette read/write mode flag 

WMODE is used by the Cassette Handler to indicate whether the 
current operation is a read or write operation; a value of zero 
indicates read, and a value of $80 indicates write. 



D15 FREQ* C0040/13 — Beep count 

FREQ is used to retain and count the number of beeps requested of 
the BEEP routine by the Cassette Handler during the OPEN command 
process. 
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E. KEYBOARD 

See Section 5 for a general description of the Keyboard Handler. 

Key Reading and Debouncing 

The console key code register is read in response to an IRQ 
interrupt that is generated u/henever a key stroke is detected by 
the hardware. The key code is compared uith the prior key code 
accepted (CHI); if the codes are not identicals then the new code 
is accepted and stored in the key code FIFO (CH> and in the prior 
key code variable (CH1>. If the codes are identicals then the new 
code is accepted only if a suitable key debounce delay has 
transpired since the prior value was accepted. 

If the key code read and accepted is the code for CCTRL3 It then 
the display start/stop flag (SSFLAG) is complemented and the 
value is not stored in the key code FIFO (CH>. 

In addition to the reading of the key datai SRTIMR is set to *30 
for all interrupts received (see E8)/ and ATRACT is set to O 
whenever a new code is accepted (see B10>. 

The Keyboard Handler obtains all key data from CH; whenever a 
code is extracted from that 1-byte FIFO* the Handler stores a 
value of *FF to the FIFO to indicate that the code has been read. 
See Section 5 for further discussion of the Keyboard Handler's 
processing of the key codes. 

El CHI* C02F2/13 — Prior keyboard character code. 

CHI contains the key code value of the key most recently veaii and 
accepted. 

E2 KEYDEL* C02F1/13 — Debounce delay timer. 

KEYDEL is set to a value of 3 whenever a key code is accepted* 
and is decremented every 60th of a second by the stage 2 VBLANK 
process (until it reaches zero). 

E3 CH C02FC/13 — Keyboard character code FIFO. 

CH is a i~byte FIFO that contains either the value of the most 
recently read and accepted key code or the value ^FF (which 
indicates that the FIFO is empty). The FIFO is normally read by 
the Keyboard Handler* but can be reaii by a user program. 

Key data can also be stored into CH by the Autorepeat logic as 
explained in the discussion relating to E8. 
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Special Functions 

Start/Stop 

Display Handler and Screen Editor output to the text or graphics 
mode screen can be stopped and started (without losing any of the 
output data) through the use of the {:CTRL3 1 key combination. 
Each key depression toggles a flag that is monitored by the above 
mentioned Handlers. When the flag is nonzero/ the handlers wait 
for it to go to zero before continuing any output. 

E4 SSFLAG C02FF, 13 — ■ Start/stop flag 

The flag is normally zero/ indicating that screen output is not 
to be stopped. The flag is complemented by every occurrence of 
the CCTRL3 1 key combination by the keyboard IRQ service routine. 

The flag is set to zero upon power-up, C SYSTEM. RESET 3 or CBREAK3 
key processing. 



C BREAK 3 Key 

E5 BRKKEY C0011,13 -- CBREAK3 key flag 

BRKKEY is used to indicate that the CBREAK3 key has been pressed. 
The value is normally nonzero and is set to zero whenever the 
CBREAK3 key is pressed. The code that detects and processes the 
CBREAK3 condition (flag - O) should set the flag nonzero again. 

BRKKEY is monitored by the following OS routines: Keyboard 
Handler! Display Handleri Screen Editor, Cassette Handler, xx? 
The detection of a CBREAK3 condition during an I/O operation 
will cause the operation to be aborted and a status of *80 to be 
returned to the user. 

The flag is set to nonzero upon Power-up, C SYSTEM. RESET 3 or upon 
aborting a pending I/O operation. 



CSHIFT3/CCONTROL3 Lock 

The keyboard control has three different modes for code 
generation that apply to the alphabetic keys A through Z: 
1) normal, 2> caps lock, and 3) control lock. 
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In normal mode/ all unmodified alphabe1;ic character keys generate 
the lowercase letter ATASCII code (*61~7A). 

In caps lock mode/ all unmodified alphabetic character keys 
generate the uppercase letter ATASCII code <*41-5A>. 

In control lock modei all unmodified alphabetic character keys 
generate the control letter ATASCII code (*01-1A). 

In all three modeSf any alphabetic character key that is modified 
<by being pressed in conjunction with the CSHIFT3 or CCTRL3 key) 
will generate the desired modified code. 

E6 SHFLOK C02BE, 13 — Shift/control lock control flag 

SHFLOK normally has one of three values: 

*00 = normal mode (no locks in effect). 
$40 ss caps lock. 
*80 = control lock. 

SHFLOK is set to *40 upon Power-up and CSYSTEM. RESET3 and is 
modified thereafter by the OS only when the C CAPS. LOWER 3 key is 
pressed (either by itself or in conjunction with the CSHIFT3 or 
CCTRL3 key). 

E7 HOLDCH* C007Cil3 — Character holding variable 

HOLDCH is used to retain the current character value prior to the 
CSHIFT3/CCONTROL3 logic process. 

Autorepeat 

The Autorepeat feature responds to the continuous depression of a 
keyboard key by replicating the key code 10 times per secondi 
after an initial 1/2 second delay. The timer variable SRTIMR is 
used to control both the initial delay and the repeat rate. 

Whenever SRTIMR is equal to zero and a key is being held downi 
the value of the key code is stored in the key code FIFO (CH). 
This logic is part of the stage 2 VBLANK process. 

E8 SRTIMR* C022Bi 13 — Autorepeat timer 

SRTIMR is controlled by two independent processes: 1) the 
keyboard IRQ service routine* which establishes the initial delay 
value and 2) the stage 2 VBLANK routine that establishes the 
repeat rate* decrements the timer and implements the auto repeat 
logic. 
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Inverse Video Control 

The Keyboard Handler allows the direct generation of more than 
half of the 256 ATASCII codes; but codes *80--9A and codes *A0- FC 
can be generated only with the "inverse video mode" active. The 
ATARI key acts as an on/off toggle for this mode/ and all 
characters (except for screen editing control characters) will be 
subject to inversion when the mode is active. 

E9 INVFLG C02B6#13 — Inverse video flag 

INVFLO is normally zero* indicating that normal video ATASCII 
codes (bit 7=0) are to be generated from keystrokes/ whenever INVFLG 
is nonzero/ inverse video ATASCII codes (bit 7=1) will be generated. 
The special control codes are exempt from this bit manipulation. 

INVFLO is set to zero by power-up and system reset. 

The Keyboard Handler inverts bit 7 of INVFLG whenever the ATARI key 
is pressed/ the lower order bits are not altered and are assumed to be 
zero. 

The Keyboard Handler's "exclusive or's" (XOR's) the ATASCII key data 
with the value in INVFLG at all times; the normal values of *00 and 
*80 thus lead to control of the inverse video bit (bit 7). 



Console Keys: CSELECT3/ CSTART3/ and C0PTI0N3 

The console keys are sensed directly from the harduiare 
register CONSOL IDOlFli see the ATARI Home Computer 
Hardware Manual for details. 



F. PRINTER 

See Section 5 for a general description of the Printer Handler. 

Printer-Buffer 

Fl PRNBUF* C03C0/403 — Printer-record buffer 

PRNBUF is the buffer used by the Printer Handler for packing printer 
data to be sent to the device controller. The buffer is 40 bytes long 
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and contains nothing but printer data. 

F2 PBUFSZ* COOIE, n — Printer-record size 

PBUFSZ contains the size of the Printer-record for the current mode 
selected; the modes and respective sizes (in decimal bytes) are shown 
below: 

Normal 40 

Double width 20 (not currently supported by the device) 

Sideways 29 

Status request 4 



F3 PBPNT* COOID* 13 — Printer-buffer index 

PBPNT contains the current index to the Printer-buffer. PBPNT ranges 
in value from zero to the value of PBUFSZ. 



) 



Internal Working Variables 

F4 PTEMP» C001F#13 — Printer Handler temporary data save 

PTEMP is used by the Printer Handler to temporarily save the value of 
a character to be output to the printer. 

F5 PTIMOT* COOlC/13 — Printer timeout value 

PTIMOT contains the timeout value for SIO calling seq.uence variable 
DTIMLO (see Section 9); PTIMOT is set to 30 (which represents a 32 
second timeout) at intiali zation timei and is updated after each 
printer status request operation to contain the value returned in the 
third byte of the status frame (see Section 5). 



0. CENTRAL I/O ROUTINE (CIO) 

See Section 5 for a description of the Central I/O Utility 

User Call Parameters 
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CIO call parameters are passed primarily through an I/O Control 
Block (lOCB); although additional device status information can be 
returned in DVSTAT# and Handler information is obtained from the 
device table (HATABS). 



I/O Control Block 

lOCB is the name applied collectively to the 16 bytes associated 
with each of the 8 provided control structures; see Section 5. 

01 IOCS C 0340/ 163 -— I/O Control Block 

The label lOCB is the location of the first byte of the first lOCB in 
the data base. For VIDs 02 through 010/ the addresses given are for 
lOCB #0 only, the addresses for all of the lOCB's are shown below: 

0340~034F lOCB #0 

0350--035F lOCB #1 

0360~036F lOCB #2 

0370~037F IOCS #3 

0380~038F lOCB #4 

0390~039F lOCB #5 

03A0-03AF lOCB #6 

03B0-03BF lOCB #7 

02 ICHID C0340il3 — Handler ID 

See Section 5. Initialized to *FF at power-up and system reset. 

03 ICDNO £0341/ 13 — Device number 
See Section 5. 

04 ICCOM C0342/13 — Command byte 
See Section 5. 

05 ICSTA C0343, 13 -•- Status 
See Section 5. 

06 ICBAL/ ICBAH C0344/ 23 — Buffer address 
See Section 5. 
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07 ICPTL, ICPTH C0346, 23 — - PUT BYTE vector 

See Section 5. Initialized to point to CIO's "lOCB not OPEN" routine 
at pou/er~up and systeoi reset. 

08 ICBLLi ICBLH C 0348, 23 — Buffer length / byte count 
See Section 5. 

09 ICAXli ICAX2 C034A,23 — Auxiliary information 
See Section 5. 

010 rCSPR C034Ci 43 — Spare bytes for Handler use 

There is no fixed assignment of these four bytes; the Handler 
associated uiith an lOCB can or may not use these bytes. 



Device Status 

Oil DVSTAT [:02EA, 43 — Device status 

See Section 5 for a discussion of the OET STATUS command 



Device Table 

012 HATABS C031A, 383 — Device table 

See Section 9 for a description of the device table. 

CIO/Handler Interface Parameters 



Communication between CIO and a Handler is accomplished using the 
6502 machine registers, and a data structure called the Zero-page 
lOCB (ZIOCB). The ZIOCB is essentially a copy of the particular 
lOCB being used for the current operation. 
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Zero-Page lOCB 

013 ZIOCB (lOCBAS) C0020, 163 -- ■ Zero-page lOCB 

The Zero-page lOCB is an exact copy (except as noted in the 
discussions that follow) of the lOCB specified fay the 6502 X 
register upon entry to CIO; CIO copies the outer level lOCB to 
the Zero-page lOCB/ performs the indicated function* moves the 
(possibly altered) Zero-page lOCB back to the outer level lOCB* 
and then returns to the caller. 

Although both the outer level lOCB and the Zero-page lOCB are 
defined to be 16 bytes in size« only the first 12 bytes are moved 
by CIO. 



014 ICHIDZ C0020,13 — Handler index number 
See Section 5. Set to *FF on CLOSE. 

015 ICDNOZ C0021/13 — Device drive number 
See Section 5. 

016 ICCOMZ C0022, 13 — Command byte 
See Section 5. 

017 ICSTAZ C0023, 13 — Status byte 
See Section 5. 

018 ICBALZ, ICBALH C0024, 23 — Buffer address 

See Section 5. This pointer variable is modified by CIO in the 
course of processing some commands; houieveri the original value 
is restored before returning to the caller. 

019 ICPTLZ, ICPTHZ 

See Section 5. Set to point to CIO's "lOCB not OPEN" routine on 
CLOSE. 

020 ICBLLZ, ICBLHZ C 0028/ 23 — Buffer length / byte count 

See Section 5. This double-byte variable* which starts out 
representing the buffer length* is modified by CIO in the course 
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of processing some commands; theni before returning to the 
caller# the transaction byte count is stored therein. 

G21 ICAXlZi ICAX2Z C002A/ 23 -— Auxiliary information 
See Section 5. 

022 ICSPRZ (ICIDNO. CIOCHR) C002C, 43 — CIO working variables 

ICSPRZ and ICSPRZ-t-l are used by CIO in obtaining the appropriate 
Handler entry point from the handler's vector table (see Section 9). 

ICSPRZ-4-2 is also labeled ICIDNO and retains the value of the 6502 X 
register from CIO entry. The X register is loaded from ICIDNO as CIO 
returns to the caller. 

ICSPRZ+3 is also labeled CIOCHR and retains the value of the 6502 A 
register from CIO entry* except for data reading type commands* in 
which case the most recent data byte read is stored in CIOCHR. The 
6502 A register is loaded from CIOCHR as CIO returns to the caller. 

Internal Working Variables 

023 ICCOMT* C0017, 13 — Command table index 

ICCOMT is used as an index to CIO's internal command table* which maps 
command byte values to Handler entry offsets (see Section 9 for more 
information). ICCOMT contains the value from ICCOMZ except when ICCOMZ 
is greater than $0E/ in which case ICCOMT is set to *0E. 

024 ICIDNO* C002E*13 — CIO call X register save/restore 
See 022. 

025 CIOCHR* C002F/13 — CIO call A register save/restore 
See 022. 



H. SERIAL I/O ROUTINE (SIO) 

See Section 9 for discussions relating to SIO. 
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User Call Parameters 

SIO call parameters are passed primarily through a Device Control 
Block; although an additional "noisy bus" option exists that is 
selectable through a separate variable. 



Device Control Block 

HI DCB C0300r 123 — Device Control Block 

DCB is the name applied collectively to the 12 bytes at locations 
0300-030B. These bytes provide the parameter passing mechanism for SIO 
and are described individually beloui. 

H2 DDEVIC C0300. n — - Device bus ID 
See Section 9. 

H3 DUNIT C0301/13 — Device unit number 
See Section 9. 

H4 DCOMND C0302# 13 — Device command 
See Section 9. 

H5 DSTATS C:0303, 13 -- Device status 
See Section 9. 

H6 DBUFLO, DBUFHI C 0304. 23 — Handler buffer address 
See Section 9. 

H7 DTIMLO C0306il3 — Device timeout 
See Section 9. 

HO DBYTLOrDBYTHI C 0308. 23 — Buffer length / byte count 
See Section 9. 
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H9 DAUX1,DAUX2 C030Ai 23 — Auxiliary information 
See Section 9. 



lus Sound Control 



HIO SOUNDR COOAlin — Quiet/noisy I/O flag 

SOUNDR is a flag used to indicate to SIO u/hether noise is to be 
generated on the television audio circuit uihen Serial I/O bus 
activity is in progress. SOUNDR equal to zero indicates that 
sound is to be inhibited^ and nonzero indicates that sound is to 
be enabled. SIO sets SOUNDR to 3 at pouier~up and system reset. 



Serial Bus Control 

Retry Logic 

SIO will attempt one complete command retry if the first attempt 
is not error free# where a complete command try consists of up to 
14 attempts to send (and acknowledge) a command frame* followed 
by a single attempt to receive COMPLETE and possibly a data 
frame. 



Hll CRETRY* C0036» 13 — Command frame retry counter 

CRETRY controls the inner loop of the retry logic# that associated 
with sending and receiving an acknowledgement of the command frame. 
CRETRY is set to 13 by SIO at the beginning of every command 
initiation* thus allowing for an initial attempt and up to 13 
additional retries. 



H12 DRETRY* C0037, 13 — Device retry counter 

DRETRY controls the outer loop of the retry logici that 
associated with initiating a command retry after a failure 
subsequent to the command frame acknowledgement. DRETRY is set to 
1 by SIO at entry* thus allowing for an initial attempt and 
1 additional retry. 
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Checksum 

The Serial I/O bus protocol specifies that all command and data 
frames must contain a checksum validation bytei this byte is the 
arithmetic sum (with end-around carry) of all of the other bytes 
in the frame. 



H13 CHKSUM* C0031,13 — Checksum value 

CHKSUM contains the frame checksum as computed by SIO for all frame 
transfers. 



H14 CHKSNT* C003B,13 — Checksum sent flag 

CHKSNT indicates to the serial bus transmit interrupt service 
routine whether the frame checksum byte has been sent yet. CHKSNT 
equal to zero indicates that the checksum byte has not yet been 
sent; after the checksum is sent# CHKSNT is then set nonzero. 



His NOCKSH* C003C, 13 — No checksum follows data flag 

NOCKSM is a flag used to communicate between the SIO top level 

code and the Serial bus receive interrupt service routine that 

the next input will not be followed by a checksum byte. A value 

of zero specifies that a checksum byte will follow, nonzero specifies 

that a checksum byte will not follow. 



Data Buffering 
General Buffer Control 

H16 BUFRLO* C0032, 13 and BUFRHI* C0033, 13 — Next byte address 

BUFRLO and BUFRHI comprise a pointer to the next buffer location 
to be read from or written to. For a data frame transfer* the 
pointer is initially set to the value contained in the SIO call 
parameters DBUFLO and DBUFHI# and is then incremented by the 
interrupt service routines as a part of normal bus data transfer. 
For a command frame transfer* the pointer is set to point to the 
SlO-maintained command frame output buffer. 

H17 BFENLO* C0034, 13 and BFENHI* £0035,13 -- Buffer end address 

BFENLO/BFENHI form a pointer to the byte following the last frame 
data byte (not including the checksum) to be sent or received. 
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BFENLO/BFENHI is the arithmetic sum of BUFRLO/BUFRHI plus the 
frame size plus -1. 



Command Frame Output Buffer 

See Section 9 for the command frame format and description. 

H18 CDEVIC* C023Ail3 — Command frame device ID 

CDEVIC is set to the value obtained by adding SIO call parameter 
DDEVIC to DUNIT and subtracting 1. 

H19 CCOMND* C023B*13 — Command frame command. 

CCOMND is set to the value obtained from SIO call parameter 
DCOMND. 

H20 CAUXl* C023C, 13 and CAUX2* C023D#13 — Auxiliary information 

CAUXi and CAUX2 are set to the values obtained from SIO call 
parameters DAUXl and DAUX2i respectively. 



Receive/Transmit Data Buffering 

H21 BUFRFL* C0038, 13 — Buffer full flag 

BUFRFL is a flag used by the serial bus receive interrupt service 
routine to indicate when the main portion of a bus frame has been 
received — all but the checksum byte. BUFRFL equal to zero 
indicates that the main portion has not been completely receivedi 
a nonzero value indicates that the main portion has been 
received. 



H22 RECVDN* C0039il3 — Receive frame done flag 

RECVDN is a flag used by SIO to communicate between the Serial 
bus receive interrupt service routine and the main SIO code. The 
flag is initially set to zero by SIO* and later set nonzero by 
the interrupt service routine after the last byte of a bus frame 
has been received. 



H23 TEMP* C023E/13 -— SIO l~byte I/O data 
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TEMP is used to receive l~byte responses from serial bus 
control lersi such as ACK, NAK. COMPLETE or ERROR. 



H24 XMTDON* C003A, i 3 — Transmit frame done flag 

XMTDON is a flag used by SIO to communicate between the Serial 
bus transmit interrupt service routine and the main SIO code. Thi 
flag is initially set to zero by SIO« and later set nonzero by 
the interrupt service routine after the last byte of a bus frame 
has been transmitted. 



SIO Timeout 

SIO uses System Timer 1 to provide the timeout capability for 
various operations initiated internally. See Section 6 for a 
discussion of the capabilities of the System Timers. TIMFLG is 
the flag used to communicate betuieen SIO and the timer initiated 
code pointed to by CDTMAl. 

H25 TIMFLO* C0317/13 — SIO operation timeout flag 

TIMFLG is used to indicate a timeout situation for a bus 
operation . The flag is initially set to i« and if it attains a 
value of zero (after the timeout period) before the current 
operation is complete^ the operation will be aborted. See also 
D2. 



H26 CDTMVl* C0218. 23 — System Timer 1 value 

This 2->byte count takes on various values depending upon the 
operation being timed. See also P4. 

H27 CDTMAi* C0226i 23 — System Timer 1 address 

This vector always points to the JTIMER routine* whose only 
function is to set TIMFLG to zero. This vector is initialized by 
SIO before every use* so that System Timer 1 can be used by any 
process that does not use SIO within a timing function. See also 
P5. 
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Internal Working Variables 

H28 STACKP* C0318, 13 — Stack pointer save/restore 

STACKP contains the value of the 6502 SP register at entry to 
SIO; this is retained to facilitate a direct error exit from an 
SIO subroutine. 



H29 TSTAT* C0319#13 — Temporary status 

TSTAT is used to return the operation status from the WAIT 
routine and will contain one of the SIO status byte values as 
shouin in Appendix B. 

H30 ERRFLO* C023F, 13 — I/O error flag 

ERRFLG is used for communication between the WAIT routine and the 
outer level SIO code. ERRFLG is normally zero# but is set to ♦FF 
uihen a device responds with an invalid response byte. 



H31 STATUS* C0030, 13 — SIO operation status 

STATUS is a zero-page variable that is used within SIO to contain 
the operation status that will be stored to the calling sequence 
parameter variable DSTATS when SIO returns to the caller. 

H32 SSKCTL* C0232, 13 — SKCTL copy 

SSKCTL is utilized by SIO to keep track of the content of the 
SKCTL CD20F3 register* which is a write-only register. 



J. ATARI CONTROLLERS 

The ATARI controllers are read as part of the Stage 2 VBLANK 
process. The encoded data is partially decoded and processed as 
shown in the subsections that follow. 



Joysticks 

Up to four joystick controllers can be attached to the computer 
console/ each with a 9-position joystick plus a trigger button. 
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Jl STICKO ~ STICK3 C0278, 43 — Joystick position sense 

The 4 joystick position sense variables contain a bit-encoded 
position sense as shown beloui: 



76543210 
+~+~+— +—+"•+•— ♦•—+-•+ 
10 O'.RILJDIUI 

where: R « O indicates joystick RIGHT sensor true. 

L as indicates joystick LEFT sensor true. 

D = indicates joystick DOWN sensor true. 

U « O indicates joystick UP sensor true. 

Nine unique combinations are possible/ indicating the possible 
joystick positions shouin below: 

CENTER HiOF 

UP ♦OE 

UP /RIGHT $06 

RIGHT *07 

DOWN/RIGHT *05 

DOWN tOD 

DOWN/LEFT *09 

LEFT *0B 

UP /LEFT *0A 



J2 STRIGO - STRIG3 C0284, 43 — Joystick trigger sense 

The four joystick trigger sense variables each contain a single bit 
indicating the position of the joystick trigger as shou/n beloui: 

7 6 5 4 3 2 10 
+— +— ♦— +~4— +-• ♦• — y-—*- 

{000000 OITJ 
^^+^^^^^^^^^^ — 1—4. 

where: T = O indicates trigger pressed. 

Paddles 

Up to eight paddle controllers can be connected to the computer/ 
each with a potentiometer and a trigger sense. 

J3 PADDLO - PADDL7 £0270/ 83 — Paddle position sense 

There is a single-byte variable associated with each paddle 
position sense; the values range from 228 for full 
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counterclockuiise rotation to 1 for -full clockwise rotation. 

The paddle values are often converted by the user* as shown 
beloui« to give a result of for full counterclockwise rotation 
and 227 for full clockwise rotation: 

VALUE :» 228 - PADDLX; 

J4 PTRIOO— PTRIG7 C027C, 83 — Paddle trigger sense 

The 8~paddle trigger sense variables each contain a single bit 
indicating the position of the paddle trigger as shown below: 

76543210 

{000000 OITJ 

where: T = indicates trigger pressed. 

Light Pen 

The OS reads the position of a single light pen and stores the 
horizontal and vertical position codes in two variables; these codes 
are not the same as the actual screen coordinates. The pen position 
codes for different portions of the screen are shown below: 

Left edge — 67. 

Codes increase in increments of one to a value of 227# then go to 
and continue to increase monotonically <one count per color clock). 
Right edge — 7. 

Upper edge — 16. 

Codes increase in increments of one Cone count per two raster 

lines). Lower edge — ^^111. 

The light pen hardware will read and latch the pen position 60 times 
per second' independent of the pen button position/ which is 
separately sensed. 

In order for the light pen to operate it must be positioned over a 
portion of the screen which has sufficient luminance to activate the 
photosensor in the pen* a blank (dark) screen will generally not 
provide enough luminance to utilize the light pen. 

J5 LPENH C0234, 13 — Light pen horizontal position code 

LPENH contains the horizontal position code for the light pen; the 
algorithm below (written in Pascal) shows the conversion from position 
code to screen coordinate (screen mode 7): 

IF LPENH < 33 •£ check for rollover point > 

THEN •€ adjust values to right of rollover > 
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XPOS := LPENH + 227 
ELSE < no adjustment to left of rollover point > 

XPOS := LPENH; 
XPOS := XPOS - 67; < adjust for left edge offset > 
IF XPOS < THEN XPOS := O; 
IF XPOS > 159 THEN XPOS := 159; 

J6 LPENV C0235f 13 — Light pen vertical position code 

LPENV contains the vertical position code for the light pen; the 
algorithm beloui (written in Pascal) shou/s the conversion from position 
code to screen coordinate (screen mode 7): 

YPOS :« LPENV - 16; < adjust for upper edge offset > 
IF YPOS < O THEN YPOS := 0; 
IF YPOS > 95 THEN YPOS := 95; 

J7 STICKO - STICK3 C0278, 43 — Light pen button sense 

The light pen button sense is encoded in one of STICKO - STICKS 
(depending upon the actual controller port used) as shown 
below: 

7 

JOSOIOITl 

where: T « O indicates the light pen button is pressed. 

Driving Controllers 

The driving controller has no position stops and thus allows unlimited 
rotation in either direction; the output of the controller is a 2--bit 
Gray code which can be used to determine the direction of rotation. 
The controller is sensed using the same internal hardware as the 
joysticki thus the same data base variables are used for both. 
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J8 STICKO - STICKS C0278i 43 — Driving controller sense 

The 4 driving controller sense variables contain an encoded 
rotation (position) sense value# as shown below: 

7 6 5 4 3 2 10 

4— I— •♦—+—♦— +-+--+--+ 

10 1 IJvalJ 

+-4— +-+—♦••— !—+—♦— + 

where a clockwise rotation of the controller produces the following 
continuous sequence of four values (shown in hexadecimal): 



OF, OD, OCOE. OF, OD, 



and a counterclockwise rotation of the controller produces the 
following continuous sequence of four values: 



OF, OE, OCiOD, OF, OE, 



J9 STRIOO ~ STRIG3 C 0284, 43 — Driving trigger sense 

The four driving trigger sense variables each contain a single bit 
indicating the position of the driving trigger as shown below: 

76543210 

+—♦— +— +-- 1— -4— 4— +— + 

JO 0IT5 

where: T = indicates trigger pressed. 

K. DISK FILE MANAGER 

See Section 5 for information relating to the Disk File Manager. 

Kl FMSZPO* C0043, 73 -- FMS reserved space 

FMSZPG is the reserved space in the database for the variables shown 
below; the names associated with K2 through K5 are not in the system 
equate file. 

K2 ZBUFP» t0043, 23 -- Buffer pointer 

K3 ZDRVA* C0045, 23 — Drive pointer 

K4 ZSBA* C 0047, 23 — Sector buffer pointer 
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K5 ERRNO* C0049. 13 — Error number 



L. DISK UTILITY POINTER 

LI DSKUTL* COOlA/33 — Page-zero pointer variable 

M. FLOATING POINT PACKAGE 

See Section 8 for a description of the Floating Point Package. 

Ml FRO C00D4.63 — FP register 

M2 FRE* COODAi63 — FP register (internal) 

M3 FRl COOEO/63 "- FP register 1 

M4 FR2» C00E6f63 — FP register 2 (internal) 

MS FRX* CODEC/ 13 — Spare (unused) 

M6 EEXP* COOED/ 13 — Exponent value (internal) 

M7 NSIGN* COOEE/13 • — Sign of mantissa (internal) 

MB ESIGN* COOEF/13 — Sign of exponent (internal) 

M9 FCHRFLG* COOFO/13 ~~ First character flag (internal) 

MIO DIGRT* COOFl, 13 — Digits to right of decimal point 

Mil CIX COOF2/13 -— Character index 

M12 INBUFF C00F3, 23 —- Input text buffer pointer 
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M13 ZTEMPl* C00F5, 23 — Temporary storage 

M14 ZTEMP4* C00F7i23 — Temporary storage 

M15 ZTEMP3» COOF9i23 — Temporary storage 
M16 FLPTR COOFCi23 — Pointer to FP number 

M17 FPTR2* COOFE/23 -— FP package use 

M18 LBPRl* C057E, 13 ■— LBUFF preamble 

M19 LBPR2* C0S7F, 13 — LBUFF preamble 

M20 LBUFF C0580i 963 — Text buffer 

M21 PLYARG» COSEOi 63 — FP register (internal) 

M22 FPSCR/FSCR* C05E6, 63 — FP register (internal) 

M23 FPSCRl/SCRl* COSECi 63 — FP register (internal) 

M24 DEGFLG/RADFL<5 COOFB, 13 — Degrees/radians flag 

DEGFLO » indicates radiansi 6 indicates degrees. 

N. Pottier-Up and SYSTEM RESET 

See Section 7 for details of the pouier-*up and system reset 
operations. 

RAM Sizing 

During power-up and system reset the first non-RAM address above 1000 
hex is located and its address retained using a nondestructive 
test. The first byte of every 4K memory "block" is tested to see if 
it is alterable; if so* the original value is restored and the next 
block is testedr and if not/ that address is considered to be the 
end of RAM. 
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Nl RAMLO*/TRAMSZ* C0004, 33 — RAM data/test pointer (temporary) 

RAMLO+1 contains the LSB of the address to be tested (always =» 0) 
and TRAMSZ (same as RAMLO+2) contains the MSB of the address to be 
tested. RAMLO+0 contains the complemented value of the data 
originally contained in the memory location being tested. 

Later in the initialization process these variables are used for 
totally unrelated functions; but first the value in TRAMSZ is moved 
to the variables RAMSIZ and MEMTOP+1. 



N2 TSTDAT* C0007/13 — Test data byte save 

TSTDAT contains the original value of the memory location being 
tested. 



Diskette/Cassette-Boot 

As a part of the Pouier~up sequencei software can be booted from an 
attached disk drive or cassette player as explained in Section 10. 

N3 DOSINI COOOC#23 — Diskette-boot initialization vector. 

OOSINI contains the disk booted software initialization address 
from the beginning of the boot file (see Section 10) whenever a 
diskette-boot is successfully completed. 

N4 CKEY* C004A, 13 — Cassette-boot request flag 

CKEY is an internal flag used to indicate that the console CSTART3 
key was pressed during Power-up# thus indicating that a 
cassette-boot is desired. CKEY equals zero when no cassette-boot is 
requested/ and is nonzero when a cassette-boot is requested. The 
flag is cleared to zero after a cassette-boot. 

N5 CASSBT* C004B/13 — Cassette-booting flag 

CASSBT is used during the cassette-boot process to indicate to 
shared code that the cassette is being booted and not the diskette. 
CASSBT equal to zero indicates a diskette-boot« and nonzero indicates 
a cassette-boot. 

N6 CASINI C0002f 23 — Cassette-boot initialization vector 

CASINI contains the cassette-booted software initialization address 
from the beginning of the boot file (see Section 10) whenever a 
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cassette-boot is successfully completed. 

N7 BOOT?* C0009i n — Successful diskette/cassette-boot flag. 

BOOT? indicates to the initialization processor uihich# if any* of 
the boot operations uient to successful completion. The flag values 
are set by the OS and the format for the variable is shown below: 

7 6 5 4 3 2 10 

•4— +-+—♦—->— 4— ♦—4—+ 
{ ICiDi 

4—4-— ♦—+-•♦— 4— +—♦—•+• 

uihere: G » 1 indicates that the cassette-boot was completed. 
D B 1 indicates that the diskette-boot was completed. 

N8 DFLAGS* C0240, 13 — Diskette flags 

DFLA6S contains the value of the first byte of the boot filei after 
diskette-boot. See Section 10. 



N9 DBSECT* C0241/13 — Diskette-boot sector count 

D6SECT is initially set to the value of the second byte of the boot 
file* during a diskette-booti and is then used to control the number 
of additional diskette sectors readi if any. 

NIO BOOTAD* {:0242f23 — Diskette-boot memory address 

BOOTAD is initially set to the value of the third and fourth 
bytes of the boot filei during a diskette-boot/ and is not 
modified thereafter. 



Environment Control 

Ifi at the end of a power-up or system reset* control is not 
given to one of the cartridges (as explained in Sections 7 and 10)« 
then program control passes to the address contained in the data 
base variable DOSVEC. 

Nil COLDST* C0244, 13 — Coldstart complete flag 

COLDST is used by the initialization routine to detect the case of 
a system reset occurring before the completion of the power-up 
process. COLDST is set to *FF at the beginning of the power-up 
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sequence and is set to at the completion; if a system reset 
occurs tiihile the value is nonzero* the pouier-up sequence will be 
reinitiated (rather than initiating a system reset sequence). 

N12 DOSVEC COOOA, 23 — Noncartridge control vector 

At the beginning of power-up the OS sets DOSVEC to point to the 
"blackboard" routine; DOSVEC can then be altered as a consequence 
of a diskette-boot or cassette-boot (as explained in Section 10) to 
establish a new control program. Control will be passed throug 
DOSVEC on all power-up and system reset conditions in which a 
cartridge does not take control first. 



System Reset 



N13 WARMST C0008. 13 — Warmstart flag 

WARMST equals *FF during a system reset (warmstart) 
initialization and equals during a power-up initialization 
(coldstart ). 



P. INTERRUPTS 

See Section 6 for a discussion of interrupt processing. 

Pi CRITIC l[0042rl3 — Critical code section flag 

CRITIC is used to signal to the VBLANK interrupt processor that a 
critical code section is executing without IRQ interrupts being 
inhibited; the VBLANK interrupt processor will' stop interrupt 
processing after stage 1 and before stage 2/ just as if the 6502 
processor I bit were set* when CRITIC is set. 

CRITIC equal to zero indicates that the currently executing code 
section is noncritical< while any nonzero value indicates that the 
currently executing code section is critical. 

P2 POKMSK COOIO, 13 — POKEY interrupt mask 

POKMSK is a software maintained interrupt mask that is used in 
conjunction with the enabling and disabling of the various POKEY 
interrupts. This mask is required because the POKEY interrupt 
enable register IRQEN CD20E3 is a write-only register* and at any 
point in time the system can have several users independently 
enabling and disabling POKEY interrupts. POKMSK is updated by the 
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users to always contain the current content of IRQEN. 

Systefit Timers 

The System Timers are discussed in detail in Section 6. 

Realtime Clock 

The realtime clock Cor frame counteri as it is sometimes called) 
is incremented as part of the stage 1 VBLANK process as explained 
in Section 6. 

P3 RTCLOK £00121 33 — Realtime frame counter 

RTCLOK+0 is the most significant byte* RTCLOK+1 the next most 
significant bytei and RTCL0K4-2 the least significant byte. See the 
discussions at D3 and preceding BIO for OS use of RTCLOK. 

System Timer 1 

System Timer 1 is maintained as part of the stage 1 VBLANK process* 
and thus has the highest priority of any of the user timers. 

P4 CDTMVl C0218/23 -— System Timer 1 value 

CDTMVl contains zero when the timer is inactive* otherwise it 
contains the number of VBLANKs remaining until timeout. Also see 
H26. 



P5 CDTMAl C0226*23 — System Timer 1 jump address 

CDTMAl contains the address to which to JSR should the timer 
timeout. See also H27 and Section 6. 
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System Timer 2 

System Timer 2 is maintained as part of the stage 2 VBLANK process^ 
and has the second highest priority of the user timers. The OS does 
not have any direct use for System Timer 2. 

P6 CDTMV2 C:021A,23 — System Timer 2 value 

CDTMV2 contains zero when the timer is inactivei otherwise it 
contains the number of VBLANKs remaining until timeout. 

P7 CDTMA2 C0228#23 — System Timer 2 jump address 

CDTMA2 contains the address to which to JSR should the timer 
timeout. See Section 6. 



System Timers 3, 4 and 5 

System Timers 3/ 4 and 5 are maintained as part of the stage 2 
VBLANK processf and have the lowest priority of the user timers. 
The OS does not have any direct use for these timers. 

PS CDTMV3 C021C,23. CDTMV4 C021E. 23 and CDTMV5 C 0220. 23 

These variables contain zero when the corresponding timers are 
inactive* otherwise they contain the number of VBLANKs remaining 
until timeout. 



P9 CDTMF3 C022A. 13* CDTMF4 C022C*13 and CDTMF5 C022E* 23 

Each of these l~byte variables will be set to zero should its 
corresponding timer timeout. The OS never modifies these bytes 
except to set them to zero upon timeout (and initialization). 

RAM Interrupt Vectors 

There are RAM vectors for many of the interrupt conditions within 
the system. See Section 6 for a discussion of the placing of values 
to these vectors. 
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NMI Interrupt Vectors 

PIO VDSLST C0200#23 — Display-list interrupt vector 

This vector is not used by the OS. See Section 6. 

Pll VVBLKI C0222»23 — Immediate VBLANK vector 

This vector is initialized to point to the OS stage 1 VBLANK 

P12 VVBLKD C0224, 23 — Deferred VBLANK vector 

This vector is initialized to point to the OS VBLANK exit routine. 

See Section 6. 



IRQ Interrupt Vectors 

P13 VIMIRQ C0216, 23 — General IRQ vector 

This vector is initialized to point to the OS IRQ interrupt 
processor. See Section 6. 

P14 VPRCED C0202i23 — Serial I/O bus proceed signal 

The serial bus line that produces this interrupt is not used in the 
current system. See Section 6. 

P15 VINTER C0204/23 — Serial I/O bus interrupt signal 

The serial bus line that produces this interrupt is not used in the 
current system. See Section 6. 

P16 VCBREAK3 i:0206i 23 -— BRK instruction vector 

This vector is initialized to point to a PLA# RTI seq^uence as the 
OS proper does not utilize the BRK instruction. See Section 6. 

P17 VKEYBD C0208/23 — Keyboard interrupt vector 

This vector is initialized to point to the Keyboard Handler's 
interrupt service routine. See Section 6 and the discussion 
preceding El. 
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P18 VSERIN C020A/23 — Serial I/O bus receive data ready 

This vector is initialized to point to the SIO utility's interrupt 
service routine. See Section 6. 



P19 VSEROR C020C,23 — Serial I/O bus transmit ready 

This vector is initialized to point to the SIO utility's interrupt 
service routine. See Section 6. 



P20 VSEROC C020E#23 — Serial I/O bus transmit complete 

This vector is initialized to point to the SIO utility's interrupt 
service routine. See Section 6. 



P21 VTIMRl C0210, 23, VTIMR2 C0212, 23 and VTIMR4 £0214,23 -- POKEY 
timer vectors 

The POKEY timer interrupts are not used by the OS See Section 6. 



Hardware Register Updates 

As part of the stage 2 VBLANK process, certain harduiare registers 
are updated from OS data base variables as explained in Section 6. 



P22 SDMCTL* C022F, 13 — DMA control 

SDMCTL is set to a value of $02 at the beginning of a Display 
Handler OPEN command, and then later set to a value of *22. The 
value of SDMCTL is stored to DMACTL CD4003 as part of the stage 2 
VBLANK process. 

P23 SDLSTL* C0230, 13 and SDLSTH* C0231, 13 — Display list address 

The Display Handler formats a neui display list with every OPEN 
command and puts the display list address in SDLSTL and SDLSTH. Thi 
value of these bytes are stored to DLISTL C:D4023 and DLISTH CD4033 
as part of the stage 2 VBLANK process. 

0360~036F lOCB #2 

0370~037F lOCB #3 

0380~038F lOCB #4 

0390~039F IOCS #5 

03A0-03AF lOCB #6 

03B0-03BF lOCB #7 
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NOTE: There is a potential timing problem associated with the 
updating of the hardware registers from the data base variables. 
Since the stage 2 VBLANK process is performed with interrupts 
enabledi it is possible for an IRQ interrupt to occur before the 
updating of DLISTH and DLISTL. If the processing of that 
interrupt (plus other nested interrupts) exceeds the 
vertical-blank delay (1 msec)/ then the display list pointer 
register will not have been updated when display list processing 
commences for the new framei and a screen glitch will result. 

P24 GPRIOR* C026Fil3 — Priority control 

The Display Handler alters bits 6 and 7 of GPRIOR as part of 
establishing the 6TIA mode. The value of GPRIOR is stored to 
PRIOR CD0iB3 as part of the stage 2 VBLANK process. 

P25 CHACT* C02F3. 13 — Character control 

The Display Handler sets CHACT to *02 on every OPEN command. The 
value of CHACT is stored to CHACTL £D40i3 as part of the stage 2 
VBLANK process. 

P26 CHBAS C02F4i 13 — Character address base 

The Display Handler sets CHBAS to *E0 on every OPEN command. The 
value of CHBAS is stored to CHBASE CD4093 as part of the stage 2 
VBLANK process. This variable controls the character subset for 
screen modes 1 and 2i a value of $E0 provides the capital letter! 
and number set whereas a value of $E2 provides the lowercase 
letters and special graphics set. See B55 for more information. 

P27 PCOLRx C02C0. 43 and COLORx C02C4, 53 — Color registers 
See B7 and B8. 



Internal Working Variables 

P28 INTEMP* C022D/13 — Temporary storage 
INTEMP is used by the SETVBL (SETVBV) routine. 
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R. USER AREAS 

The areas shown below are available to the user in a non-nested 
environment. See Section 4 for further information. 



Rl £0080. 1283 
R2 C0480. 6403 
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ALPHABETICAL LIST OF DATA BASE VARIABLES 
NAME VID ADDRESS SIZE 



ADDCOR 


D4 


030E, i 


ADRESS 


B39 


0064i 2 


APPMHI 


A3 


OOOE, 2 


ATACHR 


B54 


02FBi 1 


ATRAC T 


BIO 


004D, 1 


BFENHI 


H17 


0035, 1 


BFENLO 


Hi7 


0034, 1 


BITMSK 


B50 


006E, 1 


BLIM 


DIO 


028A, 1 


BOOT? 


N7 


0009, 1 


BOOTAD 


NIO 


0242, 2 


BOTSCR 


B16 


02BF, 1 


BPTR 


Dll 


003D, 1 


BRKKEY 


E5 


0011, 1 


BUFADR 


CI 


0015,2 


BUFCNT 


B42 


006B, 1 


BUFRFL 


H21 


0038, 1 


BUFRHI 


H16 


0033, 1 


BUFRLO 


H16 


0032, 1 


BUFSTR 


B43 


006C,2 


CASBUF 


D9 


03FD, 131 


CASFLG 


D8 


030F, 1 


CASINI 


N6 


0002, 2 


CASSBT 


N5 


004B, 1 


CAUXl 


H20 


023C, 1 


CAUX2 


H20 


023D, 1 


CBAUDH 


Dl 


02EF, 1 


CBAUDL 


Dl 


02EE, 1 


CCOMND 


H19 


023B, 1 


CDEVIC 


H18 


023A, 1 


CDTMAl 


P5, H27 


0226, 2 


CDTMA2 


P7 


0228, 2 


CDTMF3 


P9 


022A, 1 


CDTMF4 


P9 


022C, 1 


CDTMF5 


P9 


022E, 1 


CDTMVl 


P4, H26 


0226, 2 


CDTMV2 


P6 


021A, 2 


CDTMV3 


PS 


021C,2 
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CDTMV4 


P8 


021E. 2 


CDTMV5 


P8 


0220< 2 


CH 


E3 


02FC, 1 


CHKSNT 


H14 


003B, 1 


CHI 


El 


02F2i 1 


CHACT 


P25 


02F3, 1 


CHAR 


B55 


02FA, 1 


CHBAS 


P26 


02F4, 1 


CHKSNT 


H14 


003B, 1 


CHKSUM 


H13 


0031, 1 


CIOCHR 


G25 


002F, 1 


CIX 


Nil 


00F2, 1 


CKEY 


N4 


004A. 1 


COLAC 


B24 


0072, 2 


COLCRS 


B2 


0055i 2 


COLDST 


Nil 


0244, 1 


COL INC 


B21 


007A, 1 


COLORO 


B8/ P27 


02C4i 1 


COLOR 1 


B8, P27 


02C5, 1 


C0L0R2 


B8, P27 


02C6, 1 


COLORS 


B8i P27 


02C7, 1 


C0L0R4 


B8, P27 


02C8, 1 


COLRSH 


Bli 


004F, 1 


COUNTR 


B23 


007E, 2 


CRETRY 


Hll 


0036, 1 


CRITIC 


PI 


0042, 1 


CRSINH 


Bl 


02F0, 1 


CSTAT 


S2 


0288, 1 


DAUXl 


H9 


030A. 1 


DAUX2 


H9 


030B, 2 


DBSECT 


N9 


0241, 1 


DBUFHI 


H6 


0304, 1 


DBUFLO 


H6 


0305, 1 


DBYTHI 


H8 


0308, 1 


DBYTLO 


H8 


0309, 1 


DCB 


HI 


0300, 12 


DCOMND 


H4 


0302, 1 


DDEVIC 


H2 


0300, 1 


DEOFLO 


M24 


OOFB, 1 


DELTAC 


B22 


0077, 2 


DELTAR 


B22 


0076, 1 


DFLAOS 


N8 


0240, 1 


DIGRT 


MIO 


OOFl, 1 


D INDEX 


B35 


0057, 1 


DMASK 


B28 


02A0, 1 


DOSINI 


N3 


000C,2 


DOSVEC 


N12 


000 A, 2 


DRETRY 


H12 


0037, 1 


DRKMSK 


B12 


004E, 1 


DSKTIM 


C2 


0246, 1 


DSKUTL 


LI 


001 A, 2 


DSPFLG 


B27 


02FE, 1 


DSTAT 


B34 


004C, 1 
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DSTATS 


H5 


DTIMLO 


H7 


DUN IT 


H3 


DUNUSE 


S3 


DVSTAT 


Gil 


EEXP 


M6 


ENDPT 


B25 


ERRFLG 


H30 


(ERRNO 


K5) 


ESCFLO 


B26 


ESIGN 


M8 


FCHRFL 


M9 


FEOF 


D12 


FILDAT 


B17 


FILFLO 


B18 


FLPTR 


ma 


FMSZPO 


Kl 


FPSCR 


M22 


FPSCRl 


M23 


FPTR2 


M17 


FRO 


Ml 


FRl 


M3 


FR2 


M4 


FRE 


M2 


FREQ 


D15 


FRMADR 


B41 


FRX 


M5 


FSCR 


H22 


FSCRl 


M23 


FTYPE 


D13 


©PRIOR 


P24 


HATABS 


G12 


HOLDl 


B30 


H0LD2 


B31 


H0LD3 


B32 


H0LD4 


B20 


HOLDCH 


E7 


ICAXi 


G9 


ICAXIZ 


G21 


ICAX2 


G9 


ICAX2Z 


G21 


ICBAH 


06 


ICBAHZ 


G18 


ICBAL 


G6 


ICBALZ 


G18 


ICBLH 


G8 


ICBLHZ 


G20 


ICBLL 


08 


ICBLLZ 


G20 



0303i 1 
0306, 1 
0301, 1 
0307, 1 
02EA, 4 

OOED, 1 
0074, 2 
023F, 1 
0049, 1 
02A2, 1 
OOEF, 1 

OOFO, 1 
003F, 1 
02FD, 1 
02B7, 1 
00FC,2 
0043, 7 
05E6, 6 
05EC,6 
OOFE, 2 
00D4, 6 
OOEO, 6 
00E6, 6 
OODA, 6 
0040, 1 
0068, 2 
OOEC, 1 
05E6, 6 
05EC,6 
003E, 1 

026F, 1 

031A, 38 
0051, 1 
029F, 1 
0290, 1 
02BC, 1 
007C, 1 

034A, 1 
002A, 1 
034B, 1 
002B, 1 
0345, 1 
0025, 1 
0344, 1 
0024, 1 
0349, 1 
0029, 1 
0348, 1 
0028, 1 
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ICCOM 


G4 


0342, 1 


ICCOMT 


G23 


0017, 1 


ICCOMZ 


G16 


0022, 1 


ICDNO 


G3 


0341, 1 


ICDNOZ 


G15 


0021, 1 


ICHID 


G2 


0340, 1 


ICHIDZ 


G14 


0020, 1 


ICIDNO 


G24. G2 


2002E, 1 


ICPTH 


G7 


0347, 1 


ICPTHZ 


G19 


0027, 1 


ICPTL 


G7 


0346, 1 


ICPTLZ 


G19 


0026, 1 


ICSPR 


GIO 


034C, 4 


ICSPRZ 


G22 


002C, 4 


ICSTA 


G5 


0343, 1 


ICSTAZ 


G17 


0023, 1 


INBUFF 


M12 


00F3, 2 


INSDAT 


B45 


007D, 1 


INTEMP 


P28 


022D, 1 


INVFLG 


E9 


02B6, 1 


lOCB 


Gl 


0340, 16 


lOCBAS 


G13 


0020, 16 


KEYDEL 


E2 


02F1, 1 


LBFEND 


M20 


0580, 96 


LBPRl 


me 


057E, 1 


LBPR2 


M19 


057F, 1 


LBUFF 


M20 


0580, 96 


LINBUF 


B51 


0247, 40 


LMARON 


B5 


0052, 1 


LOGCOL 


B15 


0063, 1 


LOGMAP 


B14 


02B2, 4 


MEMLO 


Al 


02E7, 2 


MEMTOP 


A2 


02E5, 2 


MLTTMP 


B40 


0066, 2 


NEWCOL 


B19 


0061,2 


NEWROW 


B19 


0060, 1 


NOCKSM 


HIS 


003C, 1 


NSIGN 


M7 


OOEE, 1 


OLDADR 


B38 


005E, 2 


OLDCHR 


B37 


005D, 1 


OLDCOL 


B3 


005B, 2 


OLDROM 


B3 


005A, 1 


OPNTMP 


B40 


0066, 2 


PADDLO 


J3 


0270, 1 


PADDLl 


J3 


0271, 1 


PADDL2 


J3 


0272, 1 


PADDL3 


J3 


0273, 1 


PADDL4 


J3 


0274, 1 
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PADDL5 


J3 




0275i 1 




PADDL6 


J3 




0276, 1 




PADDL7 


J3 




0277/ 1 




pbpnt' 


F3 




OOiD, 1 




PBUFSZ 


F2 




OOlEi 1 




PCOLRO 


B7, P27 




02C0i 1 




PCOLRl 


B7i P27 




02C1, 1 




PC0LR2 


B7, P27 




02C2, 1 




PC0LR3 


B7i P27 




02C3, 1 




PLYARG 


M21 




05E0, 6 




POKMSK 


P2 




0010, 1 




PRNBUF 


Fl 




03C0, 40 




PTEMP 


F4 




OOIF, 1 




PTIMOT 


F5 




OOIC, i 




PTRIGO 


J4 




027C, 1 




PTRIGl 


J4 




027D, 1 




PTRIG2 


J4 




027E, 1 




PTRIG3 


J4 




027F, 1 




PTRIG4 


J4 




0280, 1 




PTRIG5 


J4 




0281, 1 




PTRIG6 


J4 




0282, 1 




PTRIG7 


J4 




0283, 1 




RADFLG 


M24 




OOFB, 1 




RAMLO 


Nl 




0004, 3 




RAMSIZ 


A5 




02E4, 1 




RAMTOP 


A4 




006A, 1 




RECVDN 


H22 




0039, 1 




RMARGN 


B6 




0053, 1 




ROWAC 


B24 




0070, 2 




ROMCRS 


B2 




0054, 1 




ROWING 


B21 




0079, 1 




RTCLOK 


P3 




0012, 3 




SAVADR 


B41 




0068, 2 




SAVIO 


D7 




0316, 1 




SAVMSC 


B36 




0058, 2 




SCRFLG 


B9 




02BB, 1 




SDLSTH 


P23 




0231, 1 




SDLSTL 


P23 




0230, 1 




SDMCTL 


P22 




022F, 1 




SHFAMT 


B29 




006F, 1 




SHFLOK 


E6 




02BE, 1 




SOUNDR 


HIO 




0041, 1 




SRTIMR 


E8 




022B, 1 




SSFLAG 


E4 




02FF, 1 




SSKCTL 


H32 




0232, 1 




STACKP 


H28 




0318, 1 




STATUS 


H31 




0030, 1 




STICKO 


Jii J7, 


J8 


0278, 1 




STICK! 


Jl, J7/ 


J8 


0279, 1 




STICK2 


J1,J7, 


J8 


027A, 1 




STICK3 


Jt,J7i 


J8 


027B, 1 




STRIGO 


J2, J7. 


J9 


0284, 1 
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STRIGl 


J2, v/7. J9 


0285, 1 


STRIG2 


J2, J7, J9 


0286/ 1 


STRIG3 


J2, J7, J9 


0284. 4 


SUBTMP 


B48 


029E, 1 


SWPFLO 


B44 


007B» 1 


TABMAP 


B13 


02A3, 15 


TEMP 


H23 


023E. 1 


TEMPI 


D5 


0312. 2 


TEMP3 


D6 


0315. 1 


TIMERl 


D3 


030C.2 


TIMER2 


D3 


0310.2 


TIMFLO 


D2i H25 


0317. 1 


TINDEX 


B49 


0293. 1 


TMPCHR 


B33 


0050. 1 


TMPCOL 


B46 


02B9. 2 


TMPLBT 


B47 


02A1. 1 


TMPROW 


B46 


02B8. 1 


TOADR 


B40 


0066. 2 


TRAMSZ 


Nl 


0004. 3 


TSTAT 


H29 


0319. 1 


TSTDAT 


N2 


0007. 1 


TXTCOL 


B4 


0291.2 


TXTMSC 


B52 


0294.2 


TXTOLD 


B53 


0296. 6 


TXTROW 


B4 


0290. 1 


USAREA 


Rl 


0080. 128 


VBREAK 


P16 


0206. 2 


VDSLST 


PIO 


0200. 2 


VIMIRQ 


P13 


0216. 2 


V INTER 


P15 


0204. 2 


VKEYBD 


P17 


0208. 2 


VPRCED 


P14 


0202. 2 


VSERIN 


P18 


020A. 2 


VSEROC 


P20 


020E. 2 


VSEROR 


P19 


020C.2 


VTIMRl 


P21 


0210.2 


VTIMR2 


P21 


0212. 2 


VTIMR4 


P21 


0214.2 


WBLKD 


P12 


0224. 2 


WBLKI 


Pll 


0222. 2 


WARMST 


N13 


0008. 1 


WMODE 


Pi4 


0289. 1 


XMTDON 


H24 


003 A. 1 


< ZBUFF 


K2) 


0043. 2 


< ZDRVA 


K3> 


0045. 2 


ZIOCB 


G13 


0020. 16 


(ZSBA 


K4) 


0047. 2 


ZTEMPl 


M13 


00F5. 2 
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ZTEMP3 Ml 5 00F9, 2 

ZTEMP4 Ml 4 00F7, 2 
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MEMORY ADDRESS ORDERED LIST OF DATABASE VARIABLES 



ADDRESS 


VID 




NAME 


0000- 


-0001 


S7 




LNZBS 


0002- 


-0003 


N6 




CASINI 


0004- 


-0006 


Nl 




RAMLOi TRAMSZ 


0007 




N2 




TSTDAT 


0008 




N13 




WARMST 


0009 




N7 




BOOT? 


OOOA- 


-OOOB 


N12 




DOSVEC 


OOOC- 


-OOOD 


N3 




DOSINI 


OOOE- 


-OOOF 


A3 




APPMHI 


0010 




P2 




POKMSK 


OOH 




E5 




BRKKEY 


0012- 


-0014 


P3 




RTCLOK 


0015- 


-0016 


CI 




BUFADR 


0017 




023 




ICCOMT 


00 lA- 


-00 IB 


LI 




DSKUTL 


OOIC 




F5 




PTIMOT 


OOID 




F3 




PBPNT 


OOIE 




F2 




PBUFSZ 


OOIF 




F4 




PTEMP 


0020 




013, 


014 


ICHIDZ 


0021 




015 




ICDNOZ 


0022 




G16 




ICCOMZ 


0023 




017 




I COB AS 


0024- 


-0025 


018 




ICBALZ, ICBAHZ 


0026- 


-0027 


019 




ICPTLZ, ICPTHZ 


0028- 


-0029 


020 




ICBLLZ, ICBLHZ 


002A- 


-002B 


021 




ICAXIZ, ICAX2Z 


002C- 


-002F 


022, 


024, 025 


ICSPRZ 


0030 




H31 




STATUS 


0031 




H13 




CHKSUM 


0032- 


-0033 


H16 




BUFRLOi BUFFRHI 


0034- 


-0035 


H17 




BFENLO, BFENHI 


0036 




Hll 




CRETRY 


0037 




H12 




DRETRY 


0038 




H21 




BUFRFL 


0039 




H22 




RECVDN 


003A 




H24 




XMTDON 


003B 




H14 




CHKSNT 


003C 




HIS 




NOCKSM 


003D 




Dll 




BPTR 


003E 




D13 




FTYPE 


003F 




D12 




FEOF 


0040 




D15 




FREQ 


0041 




HIO 




SOUNDR 


0042 




PI 




CRITIC 


0043- 


-0049 


K1,K2, K3, K4, 


K5 ZBUFF, ZBUFP, ZDRVA, ZSBA 


004A 




N4 




CKEY 


004B 




N5 




CASSBT 


004C 




B34 




DSTAT 
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004D 


BIO 


ATRACT 


004E 


B12 


DRKMSK 


004F 


Bll 


COLRSH 


0050 


B33 


TMPCHR 


0051 


B30 


HOLDl 


0052 


B5 


LMARGN 


0053 


B6 


RMARGN 


0054-0056 


B2 


ROWCRS, COLCRS 


0057 


B35 


DINDEX 


0058-0059 


B36 


SAVMSC 


005A-005C 


B3 


OLDROW. OLDCOL 


005D 


B37 


OLDCHR 


005E-005F 


B38 


OLDADR 


0060-0062 


B19 


NEUROWt NEWCOL 


0063 


B15 


LOGCOL 


0064-0065 


B39 


ADRESS 


0066-0067 


B40 


MLTTMP, OPNTMP, TOADR 


0068-0069 


B41 


SAVADR/FRMADR 


006A 


A4 


RAMTOP 


006B 


B42 


BUFCNT 


006C-006D 


B43 


BUFSTR 


006E 


B50 


BITMSK 


006F 


B29 


SHFAMT 


0070-0073 


B24 


ROWACCOLAC 


0074-0075 


B25 


ENDPT 


0076-0078 


B22 


DELTAR, DELTAC 


0079-007A 


B21 


ROWING, COLINC 


007B 


B44 


SWPFLG 


007C 


E7 


HOLDCH 


007D 


B45 


INSDAT 


007E-007F 


B23 


COUNTR 


0080-OOFF 


SEE FLOATING 


POINT VARIABLE LIST AT 


0100-OlFF 


6502 STACK 




0200-0201 


PIO 


VDSLST 


0202-0203 


P14 


VPRCED 


0204-0205 


P15 


V INTER 


0206-0207 


P16 


VBREAK 


0208-0209 


P17 


VKEYBD 


020A-020B 


P18 


VSERIN 


020C-020D 


P19 


VSEROR 


020E-020F 


P20 


VSEROC 


0210-0215 


P21 


VITMRli VITMR2, VITriR4 


0216-0217 


P13 


VIMIRQ 


0218-0219 


P4, H26 


CDTMVl 


021A-021B 


P6 


CDTMV2 


021C-0221 


P8 


CDTMV3i CDTMV4, CDTMV5 


0222-0223 


Pll 


VVBLKI 


0224-0225 


P12 


VVBLKD 


0226-0227 


P5, H27 


CDTMAl 


0228-0229 


P7 


CDTMA2 


022A 


P9 


CDTMF3 



OPERATING SYSTEM CO 16555 — Appendix L 



267 



022B 


E8 


SRTIMR 


022C 


P9 


CDTMF4 


022D 


P28 


INTEMP 


022E 


P9 


CDTMF5 


022F 


P22 


SDMCTL 


0230-0231 


P23 


SDLSTL, SDLSTH 


0232 


H32 


SSKCTL 


023A 


H18 


CDEVIC 


023B 


H19 


CCOMND 


023C~023D 


H20 


CAUXl, CAUX2 


023E 


H23 


TEMP 


023F 


H30 


ERRFLO 


0240 


N8 


DFLAGS 


0241 


N9 


DBSECT 


0242-0243 


NIO 


BOOTAD 


0244 


Nil 


COLDST 


0246 


C2 


DSKTIM 


0247-026E 


B51 


LINBUF 


026F 


P24 


QPRIOR 


0270-0277 


J3 


PADDLO — PADDL7 


0278-027B 


Jl, J7, J8 


STICKO — STICK3 


027C-0283 


J4 


PTRIGO — PTRIQ7 


0284-0287 


J2, J7, J9 


STRIGO — STRI03 


0289 


D14 


WMODE 


028A 


DIO 


BLIM 


028B-028F 


SIO 


unused 


0290-0292 


B4 


TXTROW, TXTCOL 


0293 


B49 


TINDEX 


0294-0295 


B52 


TXTMSC 


0296-029B 


B53 


TXTOLD 


029D 


B32 


H0LD3 


029E 


B48 


SUBTMP 


029F 


B31 


H0LD2 


02A0 


B28 


DMASK 


02 A 1 


B47 


TMPLBT 


02A2 


B26 


ESCFLG 


02A3-02B1 


B13 


TABMAP 


02B2-02B5 


B14 


LOGMAP 


02B6 


E9 


INVFLG 


02B7 


B18 


FILFLG 


02B8-02BA 


B46 


TMPROW/ TMPCOL 


02BB 


B9 


SCRFLG 


02BC 


B20 


H0LD4 


02BE 


E6 


SHFLOK 


02BF 


B16 


BOTSCR 


02C0-02C3 


B7/ P27 


PCOLRO — PC0LR3 


02C4-02C8 


B8, P27 


PCOLRO — PC0LR4 


02E4 


A5 


RAMS I Z 


02E5-02E6 


A2 


MEMTOP 


02E7-02E8 


Al 


MEMLO 


02EA-02ED 


Oil 


DVSTAT 


02EE-02EF 


Dl 


CHBAUDL. CHBAUDH 


02F0 


Bl 


CRSINH 


02F1 


E2 


KEYDEL 
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02F2 


£1 


CHI 




02F3 


P25 


CHACT 




02F4 


P26 


CHBAS 




02FA 


B55 


CHAR 




02FB 


B54 


ATACHR 




02FC 


E3 


CH 




02FD 


B17 


FILDAT 




02FE 


B27 


DSPFLG 




02FF 


E4 


SSFLAO 




0300 


HliH2 


DCB/DDEVIC 




0301 


H3 


DUN IT 




0302 


H4 


DCOMND 




0303 


H5 


DSTATS 




0304-0305 


H6 


DBUFLOiDBUFHI 




0306 


H7 


DTIMLO 




0308-0309 


H8 


DBYTLO/DBYTHI 




030A-030B 


H9 


DAUX1,DAUX2 




030C-030D 


D3 


TIMERl 




030E 


D4 


ADDCOR 




030F 


D8 


CASFLO 




0310-0311 


D3 


TIMER2 




0312-0313 


D5 


TEMPI 




0315 


D6 


TEMP3 




0316 


D7 


SAVIO 




0317 


D2, K25 


TIMFLO 




0318 


H28 


STACKP 




0319 


H29 


TSTAT 




031A-033F 


612 


HATABS 




0340 


G1.G2 


lOCB, ICHID 




0341 


03 


ICDNO 




0342 


04 


ICCOM 




0343 


05 


ICSTA 




0344-0345 


06 


ICBAL, ICBAH 




0346-0347 


07 


ICPTL, ICPTH 




0348-0349 


08 


ICBLLi ICBLH 




034A-034B 


09 


ICAXl, ICAX2 




034C-034F 


010 


ICSPR 




0350-035F 


02-010 


(lOCB #1) 




0360-036F 


02-010 


(lOCB #2) 




0370-037F 


02-010 


(lOCB #3) 




0380-038F 


02-010 


(lOCB #4) 




0390-039F 


02-010 


(lOCB #5) 




03A0-03AF 


02-010 


(lOCB #6) 




03B0-03BF 


02-010 


(lOCB #7) 




03C0-03E7 


Fl 


PRNBUF 




03FD-047F 


D9 


CASBUF 




0480-06FF 


R2 


User Area 
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FLOATING POINT PACKAGE VARIABLES 



00D4-00D9 


Ml 


OODA-OODF 


ri2 


00E0-00E5 


M3 


00E6-00EB 


M4 


OOEC 


M5 


OOED 


M6 


OGEE 


M7 


OOEF 


M8 


OOFO 


M9 


OOFl 


MIO 


G0F2 


Mli 


00F3-00F4 


M12 


00F5-00F6 


M13 


00F7-00F8 


M14 


00F9--00FA 


M15 


OOFB 


M24 


OOFC-OOFD 


M16 


OOFE-OOFF 


M17 


057E 


M18 


057F 


M19 


0580-05FF 


M2G 


05E0~05E5 


M2i 


G5E6-05EB 


M22 


05EC-05F1 


M23 



FRO 

FRE 

FRl 

FR2 

FRX 

EEXP 

NSIGN 

ESIGN 

FCHRFLG 

DIGRT 

CIX 

INBUFF 

Z TEMPI 

ZTEMP4 

ZTEMP3 

RADFLG/DEGFLG 

FLPTR 

FPTR2 

LBPRl 

LBPR2 

LBFEND, LBUFF 

PLYARG 

FPSCR/FSCR 

FPSCRl/SCRl 
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INDEX 

The subject index contains three forms of references: 

Section number^ such as '3. ' 

Appendixi such as 'App B' 

Variable ID from Appendix L, such as 'B7'. 



ATARI standards 
ATASC I I 
attract mode 

bit mapped graphics 

blackboard mode 

BNF 

boot 

BREAK 

cartridge 

cassette baud rate determine 

cassette-boot 

cassette device 

Cassette Handler (C> 

CIO (Central I/O Utility) 

CIO/user interface 

CIO/Handler interface 

CLOSE I/O command 

coldstart (see 'Pouier-up') 

color control 

control characters 

critical section 

cursor 



12 

B54-55, 

B10--12I 



5, 

a. 



App D-G 



B28--B29# 5# App H 

3, N12/ 7, 12 

1 

3, 4, N3-10, 5i 7, 10 

E5, 6, 12 

3, 4, 7, 10 

D1-D7 

3, N3-10i 7, 10 

Dl-D15i 3, 5 

5 

01-25, 5, 9 

Gl-lli 5i App 

012-22, 9 

5i 9 



A« App B 



B7-8, 5, 6 
B26-27i 5, App D 
PI, 6 
Bl-4, 5 



database 

DCB (Device Control Block) 

DELETE I/O command 

development system 

device/filename specification 

Device Handler 

device table 

disk-boot 

disk device 

Disk File Manager (D) 

Disk Handler (resident) 

display device (screen) 

Display Handler (S) 

display list 

DOS (Disk Utilities) 

DRAW I/O command 

driving controller 

Educational System Format 

error handling 



4 

Hl-9, 

5 



5, 9 



9 

012/ 5, 

N3-10i 



13 

5 

5, 

2, 

3, 

5 

Kl-5, 5 

Cl-2, 5 

B54-55, 

Bl-55, 

4, PIO 
LI, 12 
B17-2S, 
J8-9 

Cassettes 

05, H5, 



7, 9 
5, 7, 



10 



5, App E, App H 



HI 1-12, 9, App B-C 
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EOF (end-of-file) 5 

File Management System 5 

FILL I/O command B 17-25/ 5 

floating point package 2, 4/ Ml~24i 8/ App J 

FORMAT I/O command 5 

free memory 4# Al-3, Rl-2i 4/ 7 

game controllers 3# Jl~9# 6/ 11 

GET CHARACTER I/O command 5. 9 

GET RECORD I/O command 5* 9 

OET STATUS I/O command Gil. 5. 9 

Handler (see 'device handler' and individual device handlers) 

initialization/ cartridge 7 

initialization/ Handler 7/ 9 

initialization/ interrupt 6 

initialization/ system A, 7/ 10 

internal display code 5/ B54 

interrupts 2/ Pl-28/ 6 

interrupt mask P2/ 6 

inverse video (display) E9/ 5 

I/O 2/ 4/ 5, 9 

lOCB (I/O Control Block) Gl-10/ 5/ 9 

I/O retry logic Hil-12 

joystick Jl-2 

keyboard Autorepeat E8 

keyboard device 5 

Keyboard Handler (K) El~9/ 5/ App F 

keyboard key debouncing Ei~3 

light pen 11/ App J 

LNBUG 13 

LOCK I/O command 5 
logical text lines (screen) B14-15/ 5 

memory (see 'RAM'/ 'ROM' and 'free memory') 

memory dynamics Ai-5/ Nl~2/ 4/ 5/ 7 

memory map 4 

NOTE I/O command 5 

OPEN I/O command 5/9 

paddle J3-4 

page 4/ Ml-17/ Rl/ 9 

page I 4/ 9 

peripheral devices 3 

POINT I/O command 5 

Power-up 2/ Nl-13/ 4/ 7/ 12 

printer device 5/ App G 
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Printer Handler (P) 
program development 
PUT CHARACTER I/O command 
PUT RECORD I/O command 



(I/0> 

I/O command 



RAM 

record 

RENAME 

RESET 

ROM (OS) 

RS~232~C Handler 



(R> 



Screen Editor <E) 

screen margins 

screen modes 

scrolling (text) 

serial I/O bus 

C SHI FT 3 /CONTROL lock 

SIO (Serial bus I/O Utility) 

sound control (SIO) 

SPECIAL I/O commands 

split screen 

stack 

start/stop (display) 

stage 1 VBLANK process 

stage 2 VBLANK process 

tabs (Screen Editor) 
timeout (device) 
timers (system) 

UNLOCK I/O command 
user (workspace 

vectorsi RAM 
vectors* ROM 
vertical blank interrupt 

warms tart (see 'RESET') 
wild-card (disk filename) 



Fl- 


-5, 


5 




13 








5, 


9 






5, 


9 






3, 


4, 


9 




5 








5 








2i 


Nl- 


-13/ 6, 


7, 12 


1, 


4 






5. 


9 






BI- 


-55, 


f 5 




BS- 


-6, 


5, 7 




4, 


5, 


App H 




B9, 


5 






3, 


5, 


9, App 


I 


E6'- 


-7i 


5 




HI" 


-32, P 13-21 


# 5# 9# App C 


HIO/ 


11 




5, 


9 






B16, 


5 




4 








E4i 


5 


, 12 




P3- 


-5/ 


6 




P6- 


-9i 


P22-27, 


6 


B13i 


5 




H25-27, 9 




P3- 


-9, 


6 





4, M18-23, R2 

P5, P7, PlO-21, a, 9 
5/ 9, App J 
Pli-12, 6 



ZIOCB (Zero-page lOCB) 



G13-22, 9, 0020, 16 
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400/800" 



ATARI* HOME COMPUTER SYSTEM 

OPERATING SYSTEM 
SOURCE LISTING 



A 

ATARI 



© 



A Warner Communications Company ^\v 



COPYRIGHT 19 82, ATARI, INC. 
ALL RIGHTS RESERVED 



TO ALL PERSONS RECEIVING THIS DOCUMENT 

Reproduction is forbidden without the specific written permission of 
ATARI, INC. Sunnyvale, CA 94086. No right to reproduce this document, 
nor the subject matter thereof, is granted unless by written agreement with, 
or written permission from the Corporation. 



Every effort has been made to ensure that this manual accurately 
documents this product of the ATARI Home Computer Division. 
However, due to the ongoing improvement and update of the computer 
software and hardware, ATARI, INC. cannot guarantee the accuracy 
of printed material after the date of publication and disclaims 
liability for changes, errors, or omissions. 
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LIST X 
THIS IS THE MODIFIED SEPTEMBER ATARI 400/800 COMPUTER OPERATING 
SYSTEM LISTING, MODIFIED TO ASSEMBLE ON THE MICROTEC CROSS 
ASSEMBLER. 

THIS VERSION IS THE ONE WHICH WAS BURNED INTO ROM. 
THERE IS A RESIDUAL PIECE OF CODE WHICH IS FOR LNBUG. THIS 
IS AT LOCATION *7000 WHICH IS NOT IN ROM. 

THIS IS THE REVISION B EPROM VERSION 
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PAGE 



10 




11 




12 




13 




14 




15 




16 




17 


0000 


18 




19 




20 




21 




22 


EOOO 


23 


E400 


24 


E480 


25 


E4A6 


26 


E6D5 


27 


E944 


28 


EDEA 


29 


EE78 


30 


EF41 


31 


F0E3 


32 


F3E4 


33 




34 




35 




36 




37 




38 




39 




40 




41 




42 




43 




44 




45 




46 




47 




48 




49 




50 




51 




52 




53 




54 




55 


E400 


56 


E410 


57 


E420 


58 


E430 


59 


E440 


60 




61 




62 




63 





. PAGE 

COLLEEN OPERATING SYSTEM EQUATE FILE 
NTSC/PAL ASSEMBLY FLAG 
PALFLG = iO = NTSC 1 = PAL 



MODULE ORIGIN TABLE 

CHRORG = *EOOO 

VECTBL = *E400 

VCTABL = *E480 

CIOORG = *E4A6 

INTORG = *E6D5 

SIOORG = *E944 

DSKORG = *EDEA 

PRNORG = *EE78 

CASORG « *EF41 

MONORG = *F0E3 

KBDORG = $F3E4 



CHARACTER SET 

VECTOR TABLE 

RAM VECTOR INITIAL VALUE TABLE 

CENTRAL I/O HANDLER 

INTERRUPT HANDLER 

SERIAL I/O DRIVER 

DISK HANDLER 

PRINTER HANDLER 

CASSETTE HANDLER 

MONITOR /POWER UP MODULE 

KEYBOARD/DISPLAY HANDLER 



VECTOR TABLE 

HANDLER ENTRY POINTS ARE CALLED OUT IN THE FOLLOWING VECTOR 
TABLE. THESE ARE THE ADDRESSES MINUS ONE. 



EXAMPLE FOR EDITOR 



E400 
2 
4 
6 
8 
A 
C 
. F 



OPEN 




CLOSE 




GET 




PUT 




STATUS 




SPECIAL 




JUMP TO POWER ON INITIALIZATION ROUTINE 


NOT USED 




*E400 


EDITOR 


*E410 


TELEVISION SCREEN 


*E420 


KEYBOARD 


*E430 


PRINTER 


*E440 


CASSETTE 



EDITRV 
SCRENV 
KEYBDV 
PRINTV 
CASETV 



JUMP VECTOR TABLE 
THE FOLLOWING IS A TABLE OF JUMP INSTRUCTIONS 
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64 




65 




66 


E450 


67 


E453 


68 


E456 


69 


E459 


70 


E45C 


71 


E45F 


72 


E462 


73 


E465 


74 


E468 


75 


E46B 


76 


E46E 


77 


E471 


78 


E474 


79 


E477 


80 


E47A 


81 


E47D 


82 




83 




84 




85 




86 




87 




88 


0003 


89 


0005 


90 


0007 


91 


0009 


92 


OOOB 


93 


OOOC 


94 


OOOD 


95 


OOOE 


96 




97 




98 


0011 


99 


0012 


100 


0020 


101 


0021 


102 


0022 


103 


0023 


104 


0024 


105 


0025 


106 


0026 


107 


OOFF 


108 




109 




110 




111 


0001 


112 


0002 


113 


0004 


114 


0008 


115 


OOOC 


116 


0010 


117 


0020 



iTO VARIOUS ENTRY POINTS IN THE OPERATING SYSTEM. 



DISKIV 


= 


»E450 


DSKINV 


= 


*E453 


CIOV 


= 


*E456 


SIOV 


a: 


*E459 


SETVBV 


s: 


♦E45C 


SYSVBV 


= 


*E45F 


XITVBV 


=: 


*E462 


SIOINV 


= 


*E465 


SENDEV 


= 


*E468 


INTINV 


ss 


$E46B 


CIOINV 


s 


»E46E 


BLKBDV 


= 


*E471 


WARMSV 


=: 


*E474 


COLDSV 


s= 


*E477 


RBLOKV 


= 


*E47A 


CSOPIV 


s 


*E47D 


i VCTABL 


= *E^ 


(80 



OPERATING SYSTEM EQUATES 



COMMAND CODES FOR lOCB 



OPEN 


ss 




3 


GETREC 


= 




5 


GETCHR 


s 




7 


PUTREC 


s: 




9 


PUTCHR 


=2 




$B 


CLOSE 


s: 




*C 


STAT IS 


s: 




$D 


SPECIL 


= 




*E 


; SPECIAL 


ENTRY 


COMMANDS 


DRAWLN 


= 




*11 


FILLIN 


s 




*12 


RENAME 


as 




*20 


DELETE 


= 




*21 


FORMAT 


s 




*22 


LOCKFL 


= 




*23 


UNLOCK 


= 




*24 


POINT 


= 




*25 


NOTE 


s= 




*26 


lOCFRE 


= 




*FF 


i AUXl 


EQUATES 




J <) INDICATES 


WHICH DEVICE 


APPEND 


= 




*1 


DIRECT 


= 




»2 


OPNIN 


= 




*4 


OP NOT 


ss 




$8 


OPNINO 


= 




OPNIN+OPNOT 


MXDMOD 


= 




*10 


INSCLR 


= 




*20 



DISK INITIALIZATION 

DISK INTERFACE 

CENTRAL INPUT OUTPUT ROUTINE 

SERIAL INPUT OUTPUT ROUTINE 

SET SYSTEM TIMERS ROUTINE 

SYSTEM VERTICAL BLANK CALCULATIONS 

EXIT VERTICAL BLANK CALCULATIONS 

SERIAL INPUT OUTPUT INITIALIZATION 

SEND ENABLE ROUTINE 

INTERRUPT HANDLER INITIALIZATION 

CENTRAL INPUT OUTPUT INITIALIZATION 

BLACKBOARD MODE 

WARM START ENTRY POINT 

COLD START ENTRY POINT 

CASSETTE READ BLOCK ENTRY POINT VECTOR 

CASSETTE OPEN FOR INPUT VECTOR 



OPEN FOR INPUT/OUTPUT 

GET RECORD (TEXT) 

GET CHARACTER (S) 

PUT RECORD (TEXT) 

PUT CHARACTER (S) 

CLOSE DEVICE 

STATUS REQUEST 

BEGINNING OF SPECIAL ENTRY COMMANDS 



DRAW LINE 

DRAW LINE WITH RIGHT FILL 

RENAME DISK FILE 

DELETE DISK FILE 

FORMAT 

LOCK FILE TO READ ONLY 

UNLOCK LOCKED FILE 

POINT SECTOR 

NOTE SECTOR 

lOCB "FREE" 



OPEN FOR WRITE APPEND (D), OR SCREEN READ ( 

OPEN FOR DIRECTORY ACCESS (D) 

OPEN FOR INPUT (ALL DEVICES) 

OPEN FOR OUTPUT (ALL DEVICES) 

OPEN FOR INPUT AND OUTPUT (ALL DEVICES) 

OPEN FOR MIXED MODE (E, S) 

OPEN WITHOUT CLEARING SCREEN (E, S) 



ERR LINE 


ADDR 


118 




119 




120 


0045 


121 


004B 


122 


0053 


123 


0050 


124 


0043 


125 


004D 


126 


0044 


127 




128 




129 


009B 


130 




131 




132 




133 




134 


0001 


135 




136 


0080 


137 


0081 


138 


0082 


139 


0083 


140 


0084 


141 


0085 


142 


0086 


143 


0087 


144 


0088 


145 


0089 


146 


008A 


147 


008B 


148 


008C 


149 


008D 


150 


008E 


151 


008F 


152 




153 


0090 


154 


0091 


155 


0092 


156 


0093 


157 




158 




159 




160 




161 




162 




163 




164 




165 




166 


0000 


167 




168 




169 


0002 


170 


0004 


171 


0006 
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; DEVICE NAMES 




SCREDT 


= 


'E 


KBD 


= 


'K 


DISPLY 


= 


'S 


PRINTR 


=s 


'P 


CASSET 


ss 


'C 


MODEM 


= 


'M 


DISK 


= 


'D 



SCREEN EDITOR (R/W> 

KEYBOARD <R ONLY) 

SCREEN DISPLAY (R/W) 

PRINTER (W ONLY) 

CASSETTE 

MODEM 

DISK (R/W) 



; SYSTEM EOL (CARRIAGE RETURN) 
CR = *9B 



OPERATING SYSTEM STATUS CODES 



SUCCES = 



$01 



BRKABT 


=s 


*80 


PRVOPN 


= 


$81 


NONDEV 


= 


*82 


WRONLY 


s= 


*83 


NVALID 


= 


*84 


NOTOPN 


= 


*85 


BAD IOC 


=: 


*86 


RDONLY 


= 


*87 


EOFERR 


= 


*88 


TRNRCD 


= 


*89 


TIMOUT 


=: 


*8A 


DNACK 


s 


*8B 


FRMERR 


= 


*8C 


CRSROR 


= 


$8D 


OVRRUN 


= 


*8E 


CHKERR 


s 


*8F 


DERROR 


zs 


*90 


BADMOD 


sz 


*91 


FNCNOT 


s 


*92 


SCRMEM 


= 


*93 



SUCCESSFUL OPERATION 

BREAK KEY ABORT 

lOCB ALREADY OPEN 

NON-EX ISTANT DEVICE 

lOCB OPENED FOR WRITE ONLY 

INVALID COMMAND 

DEVICE OR FILE NOT OPEN 

INVALID lOCB NUMBER 

lOCB OPENED FOR READ ONLY 

END OF FILE 

TRUNCATED RECORD 

PERIPHERAL DEVICE TIME OUT 

DEVICE DOES NOT ACKNOWLEDGE COMMAND 

SERIAL BUS FRAMING ERROR 

CURSOR OVERRANGE 

SERIAL BUS DATA OVERRUN 

SERIAL BUS CHECKSUM ERROR 

PERIPHERAL DEVICE ERROR (OPERATION NOT COMP 
BAD SCREEN MODE NUMBER 
FUNCTION NOT IMPLEMENTED IN HANDLER 
INSUFICIENT MEMORY FOR SCREEN MODE 



PAGE ZERO RAM ASSIGNMENTS 



*=»0000 
LINZBS: . RES 2 



iLINBUG RAM (WILL BE REPLACED BY MONITOR RAM 



THESE LOCATIONS ARE NOT CLEARED 



CASINI: .RES 2 
RAMLO: . RES 2 
TRAMSZ: .RES 1 



CASSETTE IN IT LOCATION 

RAM POINTER FOR MEMORY TEST 

TEMPORARY REGISTER FOR RAM SIZE 
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172 


0007 




173 






174 






175 


0008 




176 


0009 




177 


OOOA 




178 


OOOC 




179 


OOOE 




180 






181 






182 


0010 




183 


0010 




184 


0011 




185 


0012 




186 






187 


0015 




188 






189 


0017 




190 






191 


0018 




192 


OOIA 




193 






194 


OOIC 




195 


OOID 




196 


OOIE 




197 


OOIF 




198 






199 


0020 




200 


0010 




201 


0080 




202 


0020 




203 


0020 




204 


0021 




205 


0022 




206 


0023 




207 


0024 




208 


0025 




209 


0026 




210 


0027 




211 


0028 




212 


0029 




213 


002A 




214 


002B 




215 


002C 




216 


002E 




217 


002F 




218 






219 


0030 




220 


0031 




221 


0032 




222 


0033 




223 


0034 




224 


0035 




225 


0036 
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PAGE 



CLEARED ON COLDSTART ONLY 



WARMST 

BOOT?: 

DOSVEC 

DOSINI 

APPMHI 



. RES 
. RES 
. RES 
. RES 
. RES 



WARM START FLAG 

SUCCESSFUL BOOT FLAG 

DISK SOFTWARE START VECTOR 

DISK SOFTWARE INIT ADDRESS 

APPLICATIONS MEMORY HI LIMIT 



CLEARED ON COLD OR WARM START 



INTZBS =» 



POKMSK 
BRKKEY 
RTCLOK 

BUFADR: 

i 

ICCOMT: 

DSKFMS: 
DSKUTL: 

PTIMOT: 
PBPNT: 
PBUFSZ: 
PTEMP : 

ZIOCB 

lOCBSZ 

MAX IOC 

lOCBAS 

ICHIDZ 

ICDNOZ 

ICCOMZ 

ICSTAZ 

ICBALZ 

ICBAHZ 

ICPTLZ 

ICPTHZ 

ICBLLZ 

ICBLHZ 

ICAXIZ 

ICAX2Z 

ICSPRZ 

ICIDNO 

CIOCHR 

STATUS 
CHKSUM 
BUFRLO 
BUFRHI 
BFENLO 
BFENHI 
CRETRY 



. RES 
. RES 
. RES 

. RES 

. RES 

. RES 
. RES 

. RES 
. RES 
. RES 
. RES 



=* 

RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 



RES 
RES 
RES 
RES 
RES 
RES 
RES 



16 
8#I0CBSZ 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

4 

ICSPRZ+2 

ICSPRZ+3 

1 
1 
1 
1 
1 
1 
1 



INTERRUPT HANDLER 

SYSTEM MASK FOR POKEY IRQ ENABLE 

BREAK KEY FLAG 

REAL TIME CLOCK (IN 16 MSEC UNITS) 

; INDIRECT BUFFER ADDRESS REGISTER 

} COMMAND FOR VECTOR 

; DISK FILE MANAGER POINTER 
; DISK UTILITIES POINTER 

PRINTER TIME OUT REGISTER 
PRINT BUFFER POINTER 
PRINT BUFFER SIZE 
TEMPORARY REGISTER 

ZERO PAGE I/O CONTROL BLOCK 
NUMBER OF BYTES PER lOCB 
LENGTH OF THE lOCB AREA 

HANDLER INDEX NUMBER (FF = lOCB FREE) 

DEVICE NUMBER (DRIVE NUMBER > 

COMMAND CODE 

STATUS OF LAST lOCB ACTION 

BUFFER ADDRESS LOW BYTE 

iPUT BYTE ROUTINE ADDRESS - 1 

i BUFFER LENGTH LOW BYTE 

; AUXILIARY INFORMATION FIRST BYTE 

TWO SPARE BYTES (CIO LOCAL USE) 

IOCS NUMBER X 16 

CHARACTER BYTE FOR CURRENT OPERATION 

INTERNAL STATUS STORAGE 

CHECKSUM (SINGLE BYTE SUM WITH CARRY) 

POINTER TO DATA BUFFER (LO BYTE) 

POINTER TO DATA BUFFER (HI BYTE) 

NEXT BYTE PAST END OF THE DATA BUFFER (LO B 

NEXT BYTE PAST END OF THE DATA BUFFER (HI B 

NUMBER OF COMMAND FRAME RETRIES 



ERR LINE 


ADDR 


226 


0037 


227 


0038 


228 


0039 


229 


003A 


230 


003B 


231 


003C 


232 




233 




234 


003D 


235 


003E 


236 


003F 


237 


0040 


238 


0041 


239 


0042 


240 




241 


0043 


242 




243 




244 


004A 


245 


004B 


246 


004C 


247 




248 


004D 


249 


004E 


250 


004F 


251 




252 


0002 


253 


0027 


254 


0050 


255 


0051 


256 


0052 


257 


0053 


258 


0054 


259 


0055 


260 


0057 


261 


0058 


262 


00 5 A 


263 


005B 


264 


00 5D 


265 


005E 


266 


0060 


267 


0061 


268 


0063 


269 


0064 


270 


0066 


271 


0066 


272 


0068 


273 


006A 


274 


006B 


275 


006C 


276 


006E 


277 


006F 


278 


0070 


279 


0072 



Bl B2 B3 B4 
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DRETRY 


. RES 


1 


BUFRFL 


.RES 


1 


RECVDN 


. RES 


1 


XMTDON 


. RES 


1 


CHKSNT 


.. RES 


1 


NOCKSM 


.RES 


1 


> 
BPTR: 


. RES 


1 


FTYPE: 


. RES 


1 


FEOF: 


. RES 


1 


FREQ: 


. RES 


1 


SOUNDR 


. RES 


1 


CRITIC 


.RES 


1 



FMSZPG: 



RES 



CKEY: 


. RES 


1 


CASSBT 


.RES 


1 


DSTAT: 


. RES 


1 


ATRACT 


. RES 


1 


DRKMSK 


. RES 


1 


COLRSH 


. RES 


1 


LEDGE 


s 


2 


REDOE 


= 


39 


TMPCHR 


. RES 


1 


HOLDl: 


. RES 


1 


LMARGN 


. RES 


1 


RMARGN 


. RES 


1 


ROWCRS 


. RES 


1 


COLCRS 


. RES 


2 


D INDEX 


. RES 


1 


SAVMSC 


. RES 


2 


OLDROW 


. RES 


1 


OLDCOL 


. RES 


2 


OLDCHR 


. RES 


1 


OLDADR 


. RES 


2 


NEWROW 


. RES 


1 


NEWCOL 


. RES 


2 


LOGCOL 


. RES 


1 


ADRESS 


. RES 


2 


MLTTMP 


. RES 


2 


OPNTMP 


= 


MLTTMP 


SAVADR 


. RES 


2 


RAMTOP 


. RES 


1 


BUFCNT 


. RES 


1 


BUFSTR 


. RES 


2 


B I TMSK 


. RES 


1 


SHFAMT 


. RES 


1 


ROW AC : 


. RES 


2 


COLAC: 


. RES 


2 



NUMBER OF DEVICE RETRIES 
DATA BUFFER FULL FLAG 
RECEIVE DONE FLAG 
TRANSMISSION DONE FLAG 
CHECKSUM SENT FLAG 
NO CHECKSUM FOLLOWS DATA FLAG 



; NOISY I/O FLAG. (ZERO IS QUIET) 

i DEFINES CRITICAL SECTION (CRITICAL IF NON-Z 

iDISK FILE MANAGER SYSTEM ZERO PAGE 



;FLAG SET WHEN GAME START PRESSED 
; CASSETTE BOOT FLAG 
; DISPLAY STATUS 

; ATRACT FLAG 

; DARK ATRACT MASK 

i ATRACT COLOR SHIFTER (EOR'ED WITH PLAYFIELD 

i LMARGN 'S VALUE AT COLD START 
; RMARGN 'S VALUE AT COLD START 



LEFT MARGIN (SET TO 1 AT POWER ON) 
RIGHT MARGIN (SET TO 38 AT POWER ON) 
CURSOR COUNTERS 



; DATA UNDER CURSOR 

; POINT DRAW GOES TO 

; POINTS AT COLUMN IN LOGICAL LINE 

; FIRST BYTE IS USED IN OPEN AS TEMP 

iRAM SIZE DEFINED BY POWER ON LOGIC 

; BUFFER COUNT 

; EDITOR GETCH POINTER 

i BIT MASK 
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280 


0074 


281 


0076 


282 


0077 


283 


0079 


284 


007A 


285 


007B 


286 


007C 


287 


007D 


288 


007E 


289 




290 




291 




292 




293 




294 




295 




296 




297 




298 




299 




300 




301 




302 




303 




304 




305 




306 




307 




308 




309 




310 


0200 


311 


0200 


312 


0202 


313 


0204 


314 


0206 


315 


0208 


316 


020A 


317 


020C 


318 


020E 


319 


0210 


320 


0212 


321 


0214 


322 


0216 


323 


0218 


324 


021A 


325 


021C 


326 


021E 


327 


0220 


328 


0222 


329 


0224 


330 


0226 


331 


0228 


332 


022A 


333 


022B 



ENDPT: 


. RES 


2 


DELTAR 


.RES 


1 


DELTAC 


.RES 


2 


ROWING 


. RES 




COL INC 


.RES 




SWPFLO 


. RES 




HOLDCH 


. RES 




INSDAT 


.RES 




COUNTR 


. RES 


2 



i NON-0 IF TXT AND REGULAR RAM IS SWAPPED 

; CH IS MOVED HERE IN KGETCH BEFORE CNTL & SH 



80 



FF ARE RESERVED FOR USER APPLICATIONS 



NOTE : SEE FLOATING POINT SUBROUTINE AREA FOR ZERO PAGE CELLS 



PAGE 1 



STACK 



PAGE TWO RAM ASSIGNMENTS 





*=*020 





INTABS 


=* 




VDSLST 


. RES 


2 


VPRCED 


. RES 


2 


V INTER 


. RES 


2 


VBREAK 


. RES 


2 


VKEYBD 


. RES 


2 


VSERIN 


. RES 


2 


VSEROR 


. RES 


2 


VSEROC 


. RES 


2 


VTIMRl 


. RES 


2 


VTIMR2 


. RES 


2 


VTIMR4 


. RES 


2 


VIMIRQ 


. RES 


2 


CDTMVl 


. RES 


2 


CDTMV2 


. RES 


2 


CDTMV3 


. RES 


2 


CDTMV4 


. RES 


2 


CDTMV5 


.RES 


2 


VVBLKI 


. RES 


2 


VVBLKD 


. RES 


2 


CDTMAl 


. RES 


2 


CDTMA2 


. RES 


2 


CDTMF3 


. RES 


1 


SRTIMR 


. . RES 


1 



INTERRUPT RAM 

DISPLAY LIST NMI VECTOR 

PROCEED LINE IRQ VECTOR 

INTERRUPT LINE IRQ VECTOR 

SOFTWARE BREAK (00) INSTRUCTION IRQ VECTOR 

POKEY KEYBOARD IRQ VECTOR 

POKEY SERIAL INPUT READY IRQ 

POKEY SERIAL OUTPUT READY IRQ 

POKEY SERIAL OUTPUT COMPLETE IRQ 

POKEY TIMER 1 IRQ 

POKEY TIMER 2 IRQ 

POKEY TIMER 4 IRQ 

IMMEDIATE IRQ VECTOR 

COUNT DOWN TIMER 1 

COUNT DOWN TIMER2 

COUNT DOWN TIMER 3 

COUNT DOWN TIMER 4 

COUNT DOWN TIMER 5 

IMMEDIATE VERTICAL BLANK NMI VECTOR 

DEFERRED VERTICAL BLANK NMI VECTOR 

COUNT DOWN TIMER 1 JSR ADDRESS 

COUNT DOWN TIMER 2 JSR ADDRESS 

COUNT DOWN TIMER 3 FLAG 

SOFTWARE REPEAT TIMER 



ERR LINE 


ADDR 


334 


022C 


335 


022D 


336 


022E 


337 


022F 


338 


0230 


339 


0231 


340 


0232 


341 


0233 


342 




343 


0234 


344 


0235 


345 


0236 


346 




347 


0238 


348 




349 


023A 


350 


02313 


351 


023C 


352 


023D 


353 




354 


023E 


355 




356 


023F 


357 




358 


0240 


359 


0241 


360 


0242 


361 


0244 


362 




363 


0245 


364 




365 


0246 


366 




367 


0247 


368 




369 


026F 


370 




371 


0270 


372 


0271 


373 


0272 


374 


0273 


375 


0274 


376 


0275 


377 


0276 


378 


0277 


379 


0278 


380 


0279 


381 


027A 


382 


027B 


383 


027C 


384 


027D 


385 


027E 


386 


027F 


387 


0280 
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CDTMF4 


. RES 1 


INTEMP 


. RES 1 


CDTMF5 


. RES 1 


SDMCTL 


. RES 1 


SDLSTL 


. RES 1 


SDLSTH 


. RES 1 


SSKCTL 


. RES 1 




. RES 1 


LPENH: 


. RES 1 


LPENV: 


. RES 1 


BRKKY: 


. RES 2 



COUNT DOWN TIMER 4 FLAG 

lAN'S TEMP (RENAMED FROM Tl BY POPULAR DEMA 

COUNT DOWN TIMER FLAG 5 

SAVE DMACTL REGISTER 

SAVE DISPLAY LIST LOW BYTE 

SAVE DISPLAY LIST HI BYTE 

SKCTL REGISTER RAM 



LIGHT PEN HORIZONTAL VALUE 
LIGHT PEN VERTICAL VALUE 
BREAK KEY VECTOR 



RES 



; SPARE 



CDEVIC 


. RES 1 


CCOMND 


. RES 1 


CAUXl: 


. RES 1 


CAUX2: 


. RES 1 


NOTE: MAY NOT 


TEMP: 


. RES 1 


; NOTE: MAY NOT 


ERRFLO 


. RES 1 


DFLAGS 


. RES 1 


DBSECT 


. RES 1 


BOOTAD 


. RES 2 


COLDST 


. RES 1 




. RES 1 


DSKTIM 


. RES 1 


LINBUF 


. RES 40 


OPRIOR 


. RES 1 


PADDLO 


.RES 1 


PADDLl 


. RES 1 


PADDL2 


. RES 1 


PADDL3 


. RES 1 


PADDL4 


. RES 1 


PADDL5 


. RES 1 


PADDL6 


. RES 1 


PADDL7 


. RES 1 


STICKO 


. RES 1 


STICKl 


.RES 1 


STICK2 


. RES 1 


STICKS 


. RES 1 


PTRIGO 


. RES 1 


PTRIOl 


. RES 1 


PTRI02 


. RES 1 


PTRI03 


. RES 1 


PTRIG4 


. RES 1 



DEVICE 



; COMMAND FRAME BUFFER 

; COMMAND 

i COMMAND AUX BYTE 1 

; COMMAND AUX BYTE 2 
NOT BE THE LAST WORD ON A PAGE 

i TEMPORARY RAM CELL 
NOT BE THE LAST WORD ON A PAGE 

; ERROR FLAG - ANY DEVICE ERROR EXCEPT TIME 



DISK FLAGS FROM SECTOR ONE 

NUMBER OF DISK BOOT SECTORS 

ADDRESS WHERE DISK BOOT LOADER WILL BE PUT 

COLDSTART FLAG (1=IN MIDDLE OF CQLDSTART) 

SPARE 

DISK TIME OUT REGISTER 

CHAR LINE BUFFER 

GLOBAL PRIORITY CELL 



POTENTIOMETER RAM CELL 



; JOYSTICK RAM CELL 



.PADDLE TRIGGER 



ERR LINE 


ADDR 


Bl B2 B3 B4 


388 


0281 




389 


0282 




390 


0283 




391 


0284 




392 


0285 




393 


0286 




394 


0287 




395 






396 


0288 




397 


0289 




398 


028A 




399 


028B 




400 


028C 




401 






402 


028E 




403 






404 






405 






406 






407 


0290 




408 


0291 




409 


0293 




410 


0294 




411 


0296 




412 


029C 




413 


029D 




414 


029E 




415 


029F 




416 


02A0 




417 


02 A 1 




418 


02A2 




419 


02A3 




420 


02B2 




421 


02B6 




422 


02B7 




423 


02B8 




424 


02B9 




425 


02BB 




426 


02BC 




427 


02BD 




428 


02BE 




429 


02BF 




430 






431 






432 


02C0 




433 


02C1 




434 


02C2 




435 


02C3 




436 


02C4 




437 


02C5 




438 


02C6 




439 


02C7 




440 


02C8 




441 
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PTRIG5 


. RES 




PTRIG6 


. RES 




PTRI07 


. RES 




SIR 100 


. RES 




STRIGl 


. RES 




STRIG2 


. RES 




STRIG3 


. RES 




CSTAT: 


. RES 




WMODE: 


. RES 




BLIM: 


. RES 




I MASK: 


. RES 




JVECK: 


. RES 


2 


> 


. RES 


2 



TXTROW 


. RES 1 


TXTCOL 


. RES 2 


T INDEX 


. RES 1 


TXTMSC 


. RES 2 


TXTOLD 


. RES 6 


TMPXl: 


. RES 1 


H0LD3: 


. RES 1 


SUBTMP 


. RES 1 


H0LD2: 


. RES 1 


DMASK: 


. RES 1 


TMPLBT 


. RES 1 


ESCFLG 


. RES 1 


TABMAP 


. RES 1 


LOGMAP 


. RES 4 


INVFLG 


. RES 1 


FILFLG 


.RES 1 


TMPROW 


. RES 1 


TMPCOL 


. RES 2 


SCRFLG 


. RES 1 


H0LD4: 


. RES 1 


H0LD5: 


. RES 1 


SHFLOK 


.RES 1 


BOTSCR 

i 


. RES 1 


i 

PCOLRO 


. RES 1 


PCOLRl 


. RES 1 


PC0LR2 


. RES 1 


PC0LR3 


. RES 1 


COLORO 


. RES 1 


COLOR 1 


. RES 1 


C0L0R2 


. RES 1 


COLORS 


. RES 1 


C0L0R4 


. RES 1 



i JOYSTICK TRIGGER O 



SPARE 



TEXT ROWGRS 

TEXT CQLCRS 

TEXT INDEX 

FOOLS CONVRT INTO NEW MSC 

OLDROW Z'. OLDCOL FOR TEXT (AND THEN SOME) 



; ESCAPE FLAG 

i LOGICAL LINE START BIT MAP 

i INVERSE VIDEO FLAG (TOGGLED BY ATARI KEY) 

; RIGHT FILL FLAG FOR DRAW 



i SET IF SCROLL OCCURS 

; TEMP CELL USED IN DRAW ONLY 

; DITTO 

; BOTTOM OF SCREEN : 24 NORM 4 SPLIT 



PO COLOR 
PI COLOR 
P2 COLOR 
P3 COLOR 
COLOR 



ERR LINE 


ADDR 


442 




443 


02C9 


444 




445 




446 




447 


02E0 


448 




449 


02E0 


450 




451 


02E4 


452 


02E5 


453 


02E7 


454 


02E9 


455 


02EA 


456 


02EE 


457 


02EF 


458 




459 


02F0 


460 


02F1 


461 


02F2 


462 




463 


02F3 


464 


02F4 


465 




466 


02F5 


467 




468 


02FA 


469 


02FB 


470 


02FC 


471 


02FD 


472 


02FE 


473 


02FF 


474 




475 




476 




477 




478 




479 




480 




481 




482 




483 


0300 


484 


0300 


485 


0301 


486 


0302 


487 


0303 


488 


0304 


489 


0305 


490 


0306 


491 


0307 


492 


0308 


493 


0309 


494 


030A 


495 


030B 
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RES 



GLBABS =» 



RES 



RES 



23 



RAMSIZ: 


. RES 


1 


MEMTOP: 


. RES 


2 


MEMLO: 


. RES 


2 




.RES 


1 


DVSTAT: 


. RES 


4 


CBAUDL: 


. RES 


1 


CBAUDH: 


. RES 


1 


} 
CRSINH: 


. RES 


1 


KEYDEL: 


. RES 


1 


CHI: 


. RES 


1 


CHACT: 


. RES 


1 


CHBAS: 


. RES 


1 



CHAR: 


. RES 1 


ATACHR: 


. RES 1 


CH: 


. RES 1 


FILDAT: 


. RES 1 


DSPFLG: 


. RES 1 


SSFLAG: 


. RES 1 



; SPARE 

/•GLOBAL VARIABLES 

; SPARE 

RAM SIZE <HI BYTE ONLY) 

TOP OF AVAILABLE USER MEMORY 

BOTTOM OF AVAILABLE USER MEMORY 

SPARE 

STATUS BUFFER 

CASSETTE BAUD RATE LOW BYTE 



i CURSOR INHIBIT (00 = CURSOR ON) 
iKEY DELAY 



1 CHACTL REGISTER RAM 
; CHBAS REGISTER RAM 

) SPARE BYTES 



ATASCII CHARACTER 

GLOBAL VARIABLE FOR KEYBOARD 

RIGHT FILL DATA (DRAW) 

DISPLAY FLAG : DISPLAY CNTLS IF NON-ZERO 

START/STOP FLAG FOR PAGING (CNTL 1). CLEARE 



PAGE THREE RAM ASSIGNMENTS 



DCB 

DDEVIC: 

DUNIT: 

DCOMND 

DSTATS 

DBUFLO 

DBUFHI 

DTIMLO 

DUNUSE 

DBYTLO 

DBYTHI 

DAUX 1 : 

DAUX2: 



=* 

. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 



DEVICE CONTROL BLOCK 

PERIPHERAL UNIT 1 BUS I. D. NUMBER 

UNIT NUMBER 

BUS COMMAND 

COMMAND TYPE/STATUS RETURN 

DATA BUFFER POINTER LOW BYTE 

DEVICE TIME OUT IN 1 SECOND UNITS 

UNUSED BYTE 

NUMBER OF BYTES TO BE TRANSFERRED LOW BYTE 

i COMMAND AUXILIARY BYTE 1 



ERR LINE 


ADDR 


476 




497 


030C 


498 


030E 


499 


030F 


500 


0310 


501 




502 


0312 


503 


0314 


504 


0315 


505 


0316 


506 


0317 


507 


0318 


508 


0319 


509 




510 




511 




512 


031A 


513 


0021 


514 




515 




516 




517 




518 


0340 


519 


0341 


520 


0342 


521 


0343 


522 


0344 


523 


0345 


524 


0346 


525 


0347 


526 


0348 


527 


0349 


528 


034A 


529 


034B 


530 


034C 


531 


0350 


532 




533 


03C0 


534 




535 


03E8 


536 




537 




538 




539 




540 




541 




542 




543 




544 




545 


03FD 


546 




547 




548 


0480 


549 
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i INITIAL TIMER VALUE 
i ADDITION CORRECTION 
i CASSETTE MODE WHEN SET 

; FINAL TIMER VALUE. THESE TWO TIMER VALUES 
ARE USED TO COMPUTE INTERVAL FOR BAUD RATE 

; TEMPORARY STORAGE REGISTER 

; TEMPORARY STORAGE REGISTER 

i TEMPORARY STORAGE REGISTER 

{SAVE SERIAL IN DATA PORT 

.TIME OUT FLAG FOR BAUD RATE CORRECTION 

iSIO STACK POINTER SAVE CELL 

{TEMPORARY STATUS HOLDER 



TIMERl 
ADDCOR 
CASFLG 
TIMER2 



TEMPI 

TEMP2 

TEMPS 

SAVIO 

TIMFLG: 

STACKP: 

TSTAT: 



. RES 2 

.RES 1 

. RES 1 

.RES 2 



RES 
RES 
RES 
RES 
RES 
RES 
RES 



HATABS: . RES 
MAXDEV = 



NOTE 



lOCB: 

ICHID 

ICDNO 

IGCOM 

ICSTA 

ICBAL 

ICBAH 

ICPTL 

ICPTH 

ICBLL 

ICBLH 

ICAXl 

ICAX2 

ICSPR 



PRNBUF: 



ORG 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 

RES 

RES 



38 {HANDLER ADDRESS TABLE 

»-HATABS-5 {MAXIMUM HANDLER ADDRESS INDEX 

THE ENTIRE lOCB DEFINITIONS HAVE BEEN MODIFIED 

» {I/O CONTROL BLOCKS 

{HANDLER INDEX NUMBER (FF = lOCB FREE) 

{DEVICE NUMBER (DRIVE NUMBER) 

{COMMAND CODE 

{ STATUS OF LAST lOCB ACTION 

{ BUFFER ADDRESS LOW BYTE 

{PUT BYTE ROUTINE ADDRESS - 1 

{ BUFFER LENGTH LOW BYTE 

{AUXILIARY INFORMATION FIRST BYTE 

4 {FOUR SPARE BYTES 

MAXIOC-IOCBSZ 

40 {PRINTER BUFFER 

21 {SPARE BYTES 



PAGE FOUR RAM ASSIGNMENTS 

CASBUF: .RES 131 {CASSETTE BUFFER 

{ USER AREA STARTS HERE AND GOES TO END OF PAGE FIVE 
US AREA: RES 128 ; SPARE 



ERR LINE 


ADDR 


550 




551 




552 




553 




554 




555 




556 




557 




558 




559 




560 




561 




562 




563 




564 




565 




566 




567 




568 




569 




570 




571 




572 


0006 


573 




574 


D800 


575 




576 


D8E6 


577 


D9AA 


578 




579 


D9D2 


580 


DA60 


581 


DA66 


582 


DADB 


583 


DB28 


584 


DD89 


585 


DD8D 


586 


DD98 


587 


DD9C 


588 


DDA7 


589 


DDAB 


590 


DDB6 


591 


DD40 


592 




593 




594 




595 


DDCO 


596 


DDCC 


597 


DECD 


598 


DEDl 


599 




600 


BD81 


601 


BD73 


602 


BE43 


603 


BEBl 
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PAGE FIVE RAM ASSIGNMENTS 

PAGE FIVE IS RESERVED AS A USER WORK SPACE 

NOTE: SEE FLOATING POINT SUBROUTINE AREA FOR PAGE FIVE CELLS 

PAGE SIX RAM ASSIGNMENTS 
PAGE SIX IS RESERVED AS A USER'S USER WORK SPACE 

FLOATING POINT SUBROUTINES 



FPREC 

; IF CARRY USED 

AFP 

FASC 
IFP 

FPI 

FSUB 

FADD 

FMUL 

FDIV 

FLDOR 

FLDOP 

FLDIR 

FLDIP 

FSTOR 

FSTOP 

FMOVE 

PLYEVL = 



EXP 

EXPIO 

LOG 

LOGIO 

; THE FOLLOWING 

SIN = 

COS 

ATAN 

SQR 



THEN CARRY 
*D800 

*D8E6 
*D9AA 

*D9D2 
*DA60 
*DA66 
*DADB 
*DB28 
*DD89 
*DD8D 
*DD98 
*DD9C 
*DDA7 
$DDAB 
*DDB6 
*DD40 



*DDC0 

*DDCC 

*DECD 

*DED1 

ARE IN BAS 

$BD81 

*BD73 

*BE43 

$BEB1 



; FLOATING PT PRECISION (# OF BYTES) 
CLEAR => NO ERROR, CARR 
; ASCII->FLOATING POINT <FP) 

INBUFF+CIX -> FRO, CIX, CARRY 
i FP -> ASCII FRO-> LBUFF (INBUFF) 
; INTEGER -> FP 

0-*FFFF (LSB,MSB) IN FRO, FR0+1->FR0 
FP -> INTEGER FRO -> FRO, FRO+1, CARRY 



FRO <:- FRO - FRl , CARRY 






FRO C- FRO + FRl , CARRY 






FRO <- FRO » FRl .CARRY 






FRO <- FRO /FRl , CARRY 






FLOATING LOAD REGO FRO 


<- 


(X, Y) 


FRO 


<- 


< FLPTR) 


REGl FRl 


<- 


<X, Y) 


FRl 


<- 


(FLPTR) 


FLOATING STORE REGO (X,Y) 


<- 


FRO 


" (FLPTR) 


<- 


FRO 



FRl <- FRO 

FRO <- P(2) = SUM(I=N TO O) (A<I)*Z»*I) CAR 
INPUT: (X,Y) = A(N), A(N-l). . . A(0) -> PLYARG 
ACC = # OF COEFFICIENTS = DEGREE+1 
FRO == Z 
; FRO C- E#*FRO = EXP10<FR0 * LOGIO(E) ) CARRY 
i FRO C- 10**FR0 CARRY 

,FRO <- LN(FRO) = LOGIO(FRO) /L0G10<E) CARRY 
iFRO <- LOGIO (FRO) CARRY 
IC CARTRIDGE: 

;FRO <:- SIN(FRO) DEGFLG=0 =>RADS, 6=>DEG. CA 

;FRO <- COS(FRO) CARRY 

;FRO <- ATAN (FRO) CARRY 

;FRO C- SQUAREROOT ( FRO ) CARRY 



ERR LINE 


ADDR 


604 




605 




606 


00D4 


607 


OODA 


608 


OOEO 


609 


00E6 


610 


OOEC 


611 


OOED 


612 


OOEE 


613 


OOEF 


614 


OOFO 


615 


OOFl 


616 


00F2 


617 


00F3 


618 


00F5 


619 


00F7 


620 


00F9 


621 


OOFB 


622 


OOFB 


623 


0000 


624 


0006 


625 


OOFC 


626 


OOFE 


627 




628 




629 




630 


057E 


631 


057F 


632 


0580 


633 


05E0 


634 


05E6 


635 


05EC 


636 


05E6 


637 


05EC 


638 


05FF 


639 




640 




641 




642 




643 




644 




645 




646 




647 




648 




649 




650 


D200 


651 


D200 


652 


D201 


653 


D202 


654 


D203 


655 


D204 


656 


D205 


657 


D206 
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FLOATING POINT ROUTINES 
*=*D4 



FRO: 

FRE: 

FRl: 

FR2: 

FRX: 

EEXP: 

NSIGN: 

ESIGN: 

FCHRFLG: 

DIGRT: 

C IX: 

INBUFF 

ZTEMPl 

Z TEMP 4 

ZTEMP3 

DEGFLG 

RADFLG: 

RADON 

DEGON 

FLPTR : 

FPTR2: 



. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 

. RES 



RES 
RES 



FPREC 
FPREC 
FPREC 
FPREC 



ZERO PAGE (NEEDED ONLY IF F. P. ROUTINES ARE CA 



FP REGO 

FP REGl 

FP SPARE 

VALUE OF E 

SIGN OF # 

SIGN OF EXPONENT 

1ST CHAR FLAG 

# OF DIGITS RIGHT OF DECIMAL 

CURRENT INPUT INDEX 

POINTS TO USER'S LINE INPUT BUFFER 



0=RADIANS, 6=DEGREES 

INDICATES RADIANS 

INDICATES DEGREES 

POINTS TO USER'S FLOATING PT NUMBER 



FLOATING PT ROUTINES' NON-ZERO PAGE RAM 



(NEEDED ONLY 

*=*57E 

RES 

RES 

RES 



IF F. P. ROUTINES CALLED) 



LBPRl 

LBPR2 

LBUFF 

PLYARG 

FPSCR 

FPSCRl 

FSCR 

FSCRl 

LBFEND 



1 

1 

128 

LBUFF+*60 

PLYARG+FPREC 

FPSCR+FPREC 

FPSCR 

FPSCRl 

»-l 



LBUFF PREFIX 1 
LBUFF PREFIX 2 
LINE BUFFER 
POLYNOMIAL ARGUMENTS 



END OF LBUFF 



COLLEEN MNEMONICS 

POKEY = *D200 

POTO = POKEY+0 

POTl = POKEY+1 

P0T2 = POKEY+2 

POTS = POKEY+3 

P0T4 = P0KEY4-4 

P0T5 = POKEY+5 

P0T6 = POKEY+6 



VBLANK ACTION: 
POTO — >PADDLO 
POTl — >PADDL1 
P0T2 — >PADDL2 
P0T3 — >PADDL3 
P0T4 — >PADDL4 
P0T5~>PADDL5 
P0T6 — >PADDL6 



DESCRIPTION: 




0-227 


IN RAM 


CELL 


0-227 


IN RAM 


CELL 


0-227 


IN RAM 


CELL 


0-227 


IN RAM 


CELL 


0-227 


IN RAM 


CELL 


0-227 


IN RAM 


CELL 


0-227 


IN RAM 


CELL 



LINE 


ADDR 


658 


D207 


659 


D208 


660 


D209 


661 


D20A 


662 


D20B 


663 


D20D 


664 


D20E 


665 


D20F 


666 


D200 


667 


D201 


668 


D202 


669 


D203 


670 


D204 


671 


D205 


672 


D206 


673 


D207 


674 


D208 


675 


D209 


676 


D20A 


677 


D20D 


678 


D20E 


679 


D20F 


680 




681 


DOOO 


682 


DOOO 


683 


DOOl 


684 


D002 


685 


D003 


686 


D004 


687 


D005 


688 


D006 


689 


D007 


690 


D008 


691 


D009 


692 


DOOA 


693 


DOOB 


694 


DOOC 


695 


DOOD 


696 


DOOE 


697 


DOOF 


698 


DOlO 


699 


DOll 


700 


D012 


701 


D013 


702 


D014 


703 


D015 


704 


D016 


705 


D017 


706 


D018 


707 


D019 


708 


DOIA 


709 


DOIB 


710 


DOIC 


711 


DOID 
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P0T7 


s 


POKEY+7 


; P0T7~>PADDL7 


0-227 IN 


RAM C 


ALLPOT 


= 


POKEY+8 


J??? 






KBCODE 


= 


POKEY+9 








RANDOM 


s 


POKE Y+ 10 








POTOO 


= 


POKEY-m 


; STROBED 






SERIN 


= 


POKEY+13 








IRQST 


= 


POKEY+14 








SKSTAT 


= 


P0KEY+i5 








AUDFl 


= 


POKEY+0 








AUDCl 


= 


POKEY+1 








AUDF2 


= 


POKEY+2 








AUDC2 


= 


POKEY+3 








AUDF3 


s 


POKEY+4 








AUDC3 


= 


POKEY-J-5 








AUDF4 


= 


POKEY+6 








AUDC4 


= 


P0KEY4-7 








AUDCTL 


=: 


POKEY+8 


iNGNE 


AUDCTL<--CSI03 


STIMER 


= 


POKEY+9 








SKRES 


ss 


POKE Y+ 10 


;NONE 


SKRES< — CSI03 


SEROUT 


= 


POKEY+13 


(NONE 


SEROUTC— CSI03 


IRQEN 


s 


POKEY+1 4 


POKMSK—> IRQEN (AFFECTED BY OPEN i 


3: OR 


SKCTL 


= 


POKEY+1 5 


( SSKCTL— >SKCTL 


SSKCTL<--CSI0 3 


CTIA 


- 


*D000 


;VBLANK ACTION: 


DESCRIPTION: 




HPOSPO 


= 


CTIA+0 








HPOSPl 


= 


CTIA+1 








HP0SP2 


s= 


CTIA+2 








HP0SP3 


= 


CTIA+3 








HPOSMO 


=: 


CTIA+4 








HPOSMl 


= 


CTIA+5 








HP0SM2 


= 


CTIA+6 








HP0SM3 


=: 


CTIA+7 








SIZEPO 


s 


CTIA+8 








SIZEPl 


= 


CTIA+9 








SIZEP2 


= 


CTIA+10 








SIZEP3 


= 


CTIA+11 








SIZEM 


= 


CTIA+12 








ORAFPO 


= 


CTIA+13 








OR AFP 1 


= 


CTIA+14 








GRAFP2 


= 


CTIA+15 








GRAFP3 


= 


CTIA+16 








GRAFM 


= 


CTIA+17 








COLPMO 


= 


CTIA+18 


PCOLRO — >COLPM0 


WITH ATTRACT 


MODE 


COLPMl 


= 


CTIA+19 


PCOLRl — >C0LPM1 


WITH ATTRACT 


MODE 


C0LPM2 


= 


CTIA+20 


PC0LR2 — >C0LPM2 


WITH ATTRACT 


MODE 


C0LPM3 


s: 


CTIA+21 


PC0LR3 — >C0LPM3 


WITH ATTRACT 


MODE 


COLPFO 


= 


CTIA+22 


CQLORO— >COLPFO 


WITH ATTRACT 


MODE 


COLPFl 


S 


CTIA+23 


C0L0R1-->C0LPF1 


WITH ATTRACT 


MODE 


CQLPF2 


S 


CTIA+24 


C0L0R2~>C0LPF2 


WITH ATTRACT 


MODE 


C0LPF3 


= 


CTIA+25 


C0L0R3~>C0LPF3 


WITH ATTRACT 


MODE 


COLBK 


= 


CTIA+26 


C0L0R4— >COLBK 


WITH ATTRACT 


MODE 


PRIOR 


= 


CTIA+27 


(ON OPEN S: OR E: ) 


GPRIOR-->PRIOR 


VDELAY 


= 


CTIA+28 








GRACTL 


= 


CTIA+29 









E: ) 



ERR LINE 


ADDR 


712 


DOIE 


713 


DOIF 


714 


DOOO 


715 


DOOl 


716 


D002 


717 


D003 


718 


D004 


719 


D005 


720 


D006 


721 


D007 


722 


D008 


723 


D009 


724 


DOOA 


725 


DOOB 


726 


DOOC 


727 


DOOD 


728 


DOOE 


729 


DOOF 


730 


DOlO 


731 


Don 


732 


D012 


733 


D013 


734 




735 


D400 


736 


D400 


737 


D401 


738 


D402 


739 


D403 


740 


D404 


741 


D405 


742 


D407 


743 


D409 


744 


D40A 


745 


D40B 


746 


D40C 


747 


D40D 


748 


D40E 


749 


D40F 


750 


D40F 


751 


D300 


752 


D300 


753 


D301 


754 


D302 


755 


D303 


756 




757 




758 




759 





ADDR Bl B2 B3 B4 
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HITCLR 


ss 


CTIA+30 












CONSOL 


= 


CTIA+31 


*08~>C0NS0L 


TURN OFF SPEAKER 


MOPF 


=: 


CTIA+0 








MIPF 


=s 


CTIA+1 








M2PF 


= 


CTIA+2 








M3PF 


=: 


CTIA->-3 








POPF 


=s 


CTIA-»-4 








PIPF 


=: 


CTIA-J-5 








P2PF 


ss 


CTIA-J-6 








P3PF 


a 


CTIA+7 








MOPL 


= 


CTIA-t-8 








MIPL 


=: 


CTIA+9 








M2PL 


= 


CTIA-J-10 








M3PL 


ss 


CTIA-»-ll 








POPL 


ss 


CTIA4-12 








PIPL 


s 


CTIA-J-13 








P2PL 


=s 


CTIA^14 








P3PL 


ss 


CTIA-H5 








TRIGO 


ss 


CTIA+16 


TRIGO-->STRIGO 






TRIGl 


ss 


CTIA+17 


TRIGl— >STRIG1 






TRI02 


= 


CTIA-4-18 


TRIG2— >STRIG2 






TRIG3 


ss 


CTIA+19 


TRIG3 — >STRIG3 






i 

ANTIC 


:= 


*D400 


VBLANK ACTION 


DESCRIPTION 


DMACTL 


= 


ANTIC+0 


DMACTL< — SDMCTL 


ON 


OPEN S 


OR E 




CHACTL 


ss 


ANTIC+1 


CHACTLC— CHACT 


ON 


OPEN S 


OR E 




DLISTL 


ss 


ANTIC-+-2 ' 


DLISTL<— SDLSTL 


ON 


OPEN S 


OR E 




DLISTH 


ss 


ANTIC+3 


DLISTH<~SDLSTH 


ON 


OPEN S 


OR E 




HSCROL 


ss 


ANTIC +4 








VSCROL 


ss 


ANTIC+5 








PMBASE 


s 


ANTIC-+-7 








CHBASE 


s= 


ANTIC +9 


CHBASEO- CHBAS 


ON 


OPEN S: OR E: 


WSYNC 


ss 


ANTIC+10 








VCOUNT 


= 


ANTIC+11 








PENH 


= 


ANTIC+12 








PENV 


ss 


ANTIC+13 








NMIEN 


ss 


ANTIC+14 


NMIEN<~40 POWER 


ON 


AND CSETVBVD 


NMIRES 


= 


ANTIC+15 


STROBED 






NMIST 


= 


ANTIC+1 5 








PIA 


ss 


*D300 


VBLANK ACTION 


DESCRIPTION 


PORTA 


ss 


PIA+0 


PORTA— >STICK0, 1 


X-Y CONTROLLERS 


PORTB 


= 


PIA+l 


PORTB— >STICK2. 3 


X-Y CONTROLLERS 


PACTL 


s 


PIA+2 


NONE 


PACTL<— 3C CINIT3 


PBCTL 


ss 


PIA+3 


NONE 


PBCTL<— 3C CINIT3 



. PAGE 



ERR LINE ADDR Bl B2 B3 B4 
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760 
761 
762 
763 
764 
765 
766 



0030 
003A 
009B 





.PAGE 




LIST 




. TITLE 


f 

ASCZER 


= 


COLON 


= 


EOL 


= 



'CENTRAL INPUT/OUTPUT (CIO) 2-7-79 
UPDATED BY AL MILLER 3-9-79 
'O ; ASCI I ZERO 

*3A i ASC 1 1 COLON 

*9B i END OF RECORD 



ERR LINE 


ADDR 


Bl 


B2 


B3 


767 










768 










769 










770 










771 


E456 


4C 


C4 


E4 


1T3. 










773 










774 










775 


E46E 


4C 


A6 


E4 


776 










777 










778 










779 










780 










781 










782 










783 










784 










785 










786 


E4A6 


A2 


00 




787 


E4A8 


A9 


FF 




788 


E4AA 


9D 


40 


03 


789 


E4AD 


A9 


CO 




790 


E4AF 


9D 


46 


03 


791 


E4B2 


A9 


E4 




792 


E4B4 


9D 


47 


03 


793 


E4B7 


8A 






794 


E4B8 


18 






795 


E4B9 


69 


10 




796 


E4BB 


AA 






797 


E4BC 


C9 


80 




798 


E4BE 


90 


E8 




799 


E4C0 


60 






800 










801 










802 


E4C0 








803 


00E4 








804 


OOCO 








805 


E4C1 


AO 


85 




806 


E4C3 


60 







CENTRAL INPUT/OUTPUT (CIO) 2-7-79 

. PAGE 

CIO JUMP VECTOR FOR USERS 
*=CIOV 
JMP CIO ;G0 TO CIO 

CIO INIT JUMP VECTOR FOR POWER UP 
*=CIOINV 
JMP CIOINT i GO TO INIT 



ERROR ROUTINE ADDRESS EQUATE 

ERRTNH =ERRTN/256 "MOVED TO LINE 788' 

ERRTNL =-ERRTNH*256+ERRTN "MOVED TO LINE 789' 



PAGE 



17 





*=CIOORG 


; CIO 


INITIALIZATION <C 


CIOINT 


: LDX 


#0 


CIOIl: 


LDA 


#IOCFRE 




STA 


ICHID, X 




LDA 


#ERRTNL 




STA 


ICPTL, X 




LDA 


#ERRTNH 




STA 


ICPTH. X 




TXA 






CLC 






ADC 


#IOCBSZ 




TAX 






CMP 


#MAXIOC 




BCC 


CIOIl 




RTS 





SET ALL lOCB'S TO FREE 

BY SETTING HANDLER ID'S=*FF 

POINT PUT TO ERROR ROUTINE 



BUMP INDEX BY SIZE 



DONE? 

NO 

YES I RETURN 



i ERROR ROUTINE FOR ILLEGAL PUT 

ERRTN =*-l 

ERRTNH =ERRTN/256 

ERRTNL =( -ERRTNH >*256-4-ERRTN 

LDY #NOTOPN ; IOCS NOT OPEN 

RTS 



ERR LINE 


ADDR 


Bl 


B2 B3 


807 








808 








809 








810 


002C 






811 








812 








813 








814 








815 


E4C4 


85 


2F 


816 


E4C6 


86 


2E 


817 








818 








819 


E4C8 


8A 




820 


E4C9 


29 


OF 


821 


E4CB 


DO 


04 


822 


E4CD 


EC 


80 


823 


E4CF 


90 


05 


824 








825 








826 


E4D1 


AO 


86 


827 


E4D3 


4C 


IB E6 


828 








829 








830 


E4D6 


AO 


00 


831 


E4D8 


BD 


40 03 


832 


E4DB 


99 


20 00 


833 


E4DE 


E8 




834 


E4DF 


C8 




835 


E4E0 


CO 


OC 


836 


E4E2 


90 


F4 


837 








838 








839 


E4E4 


AO 


84 


840 


E4E6 


A5 


22 


841 


E4E8 


C9 


03 


842 


E4EA 


90 


25 


843 


E4EC 


A8 




844 








845 








846 


E4ED 


CO 


OE 


847 


E4EF 


90 


02 


848 


E4F1 


AO 


OE 


849 


E4F3 


84 


17 


850 


E4F5 


B9 


C6 E6 


851 


E4F8 


FO 


OF 


852 


E4FA 


C9 


02 


853 


E4FC 


FO 


35 


854 


E4FE 


C9 


08 


855 


E500 


BO 


4C 


856 


E502 


C9 


04 


857 


E504 


FO 


63 


858 


E506 


4C 


C9 E5 



CENTRAL INPUT/OUTPUT <CIO) 2-7-79 

. PAGE 

i CIO LOCAL RAM (USES SPARE BYTES IN ZERO PAGE lOCB) 
ENTVEC = ICSPRZ 

CIO MAIN ROUTINE 

CIO INTERFACES BETWEEN USER AND INPUT/OUTPUT DE 
CIO: STA CIOCHR ; SAVE POSSIBLE OUTPUT CHARACTER 
STX ICIDNO ;SAVE lOCB NUMBER * N 



PAGE 



18 



CHECK FOR LEGAL lOCB 
TXA 

AND #*F 
BNE CIERRl 
CPX »MAXIOC 
BCC lOCl 



IS lOCB MULTIPLE OF 16? 

NO, ERROR 

IS INDEX TOO LARGE? 

NO 



; INVALID lOCB NUMBER — RETURN ERROR 
CIERRl: LDY #BADIOC ; ERROR CODE 
JMP CIRTNl /RETURN 

; MOVE USER lOCB TO ZERO PAGE 



lOCl: LDY 


#0 




lOClA: LDA 


lOCB, X 


USER IOCS 


STA 


lOCBAS, Y 


TO ZERO PAGE 


INX 






I NY 






CPY 


#12 


12 BYTES 


BCC 


lOClA 




; COMPUTE CIO 


INTERNAL VECTOR FOR COMMAND 


LDY 


#NVALID 


ASSUME INVALID CODE 


LDA 


ICCOMZ 


COMMAND CODE TO INDEX 


CMP 


#OPEN 


IS COMMAND LEGAL? 


BCC 


CIERR4 


NO 


TAY 






; MOVE COMMAND 


TO ZERO BASE FOR INDEX 


CPY 


#SPECIL 


IS COMMAND SPECIAL? 


BCC 


I0C2 


NO 


LDY 


#SPECIL 


YES, SET SPECIAL OFFSET INDEX 


I0C2: STY 


ICCOMT 


SAVE COMMAND FOR VECTOR 


LDA 


COMTAB-3, Y 


GET VECTOR OFFSET FROM TABLE 


BEQ 


CI OP EN 


GO IF OPEN COMMAND 


CMP 


#2 


IS IT CLOSE? 


BEQ 


CICLOS 


YES 


CMP 


#8 


IS IT STATUS OR SPECIAL? 


BCS 


CISTSP 


YES 


CMP 


#4 


IS IT READ? 


BEQ 


CIREAD 


YES 


JMP 


CIWRIT 


ELSE, MUST BE WRITE 



ERR LINE 


ADDR 


Bl 


B2 


B3 


85? 










860 










861 










862 










863 










864 


E509 


A5 


20 




865 


E50B 


C9 


FF 




866 


E50D 


FO 


05 




867 










868 










869 


E50F 


AO 


81 




870 


E511 


4C 


IB 


E6 


871 










872 










873 


E514 


20 


9E 


E6 


874 


E517 


BO 


F8 




875 










876 










877 










878 










879 


E519 


20 


3D 


E6 


880 


E51C 


BO 


F3 




881 










882 










883 


E51E 


20 


89 


E6 


884 










885 










886 


E521 


A9 


OB 




887 


E523 


85 


17 




888 


E525 


20 


3D 


E6 


889 


E528 


A5 


2C 




890 


E52A 


85 


26 




891 


E52C 


A5 


2D 




892 


E52E 


85 


27 




893 


E530 


4C 


ID 


E6 



CENTRAL INPUT/OUTPUT (CIO) 2-7-79 
. PAGE 
OPEN COMMAND 
FIND DEVICE HANDLER IN HANDLER ADDRESS TABLE 



PAGE 



19 



CI OPE 


N: LDA 


ICHIDZ 


;GET HANDLER ID 




CMP 


#IOCFRE 


i IS THIS lOCB CLOSED? 




BEQ 


IQC6 


; YES 



i ERROR — lOCB ALREADY OPEN 

CIERR3: LDY #PRVOPN ; ERROR CODE 

CIERR4: JMP CIRTNl ; RETURN 



; GO FIND DEVICE 
I0C6: JSR DEVSRC 
BCS CIERR4 



iCALL DEVICE SEARCH 

i GO IF DEVICE NOT FOUND 



DEVICE FOUND, INITIALIZE lOCB FOR OPEN 

COMPUTE HANDLER ENTRY POINT 
IOC 7: JSR COMENT 

BCS CIERR4 iGO IF ERROR IN COMPUTE 
f 
i GO TO HANDLER FOR INITIALIZATION 

JSR GOHAND ; USE INDIRECT JUMP 

; STORE PUT BYTE ADDRESS-1 INTO lOCB 

LDA #PUTCHR ; SIMULATE PUT CHARACTER 

STA ICCOMT 

COMPUTE ENTRY POINT 
MOVE COMPUTED VALUE 
TO PUT BYTE ADDRESS 



i RETURN TO USER 



JSR 


COMENT 


LDA 


ICSPRZ 


STA 


ICPTLZ 


LDA 


ICSPRZ+1 


STA 


ICPTHZ 


JMP 


CIRTN2 



ERR LINE 


ADDR 


Bl 


B2 


B3 


894 










895 










896 










897 










898 


E533 


AO 


01 




899 


E535 


84 


23 




900 


E537 


20 


3D 


E6 


901 


E53A 


BO 


03 




902 


E53C 


20 


89 


E6 


903 


E53F 


A9 


FF 




904 


E541 


85 


20 




905 


E543 


A9 


E4 




906 


E545 


85 


27 




907 


E547 


A9 


CO 




908 


E549 


85 


26 




909 


E54B 


4C 


ID 


E6 


910 










911 










912 










913 










914 


E54E 


A5 


20 




915 


E550 


C9 


FF 




916 


E552 


DO 


05 




917 










918 










919 


E554 


20 


9E 


E6 


920 


E557 


BO 


B8 




921 










922 










923 


E559 


20 


3D 


E6 


924 


E55C 


20 


89 


E6 


925 










926 










927 


E55F 


A6 


2E 




928 


E561 


BD 


40 


03 


929 


E564 


85 


20 




930 


E566 


4C 


ID 


E6 



CENTRAL INPUT /OUTPUT (CIO) 2-7-79 
. PAGE 



PAGE 20 



CLOSE COMMAND 

CICLOS: LDY #SUCCES 

STY ICSTAZ 

JSR COMENT 

BCS CICL02 

JSR GOHAND 

CICL02: LDA #IOCFRE 

STA ICHIDZ 

LDA #ERRTNH 

STA ICPTHZ 

LDA #ERRTNL 

STA ICPTLZ 

JMP CIRTN2 



i ASSUME GOOD CLOSE 

; COMPUTE HANDLER ENTRY POINT 

; GO IF ERROR IN COMPUTE 

i GO TO HANDLER TO CLOSE DEVICE 

iGET lOCB "FREE" VALUE 

; SET HANDLER ID 

; SET PUT BYTE TO POINT TO ERROR 



; RETURN 



STATUS AND SPECIAL REQUESTS 

DO IMPLIED OPEN IF NECESSARY AND GO TO DEVICE 
CISTSP: LDA ICHIDZ ; IS THERE A HANDLER 

CMP #IOCFRE 

BNE CISTl ; YES 



IDI 



; IOCS IS FREE, DO IMPLIED OPEN 

JSR DEVSRC ,FIND DEVICE IN TABLE 
BCS CIERR4 ; GO IF ERROR IN COMPUTE 

; COMPUTE AND GO TO ENTRY POINT IN HANDLER 

CISTl: JSR COMENT ; COMPUTER HANDLER ENTRY VECTOR 
JSR GOHAND ; GO TO HANDLER 



RESTORE HANDLER INDEX 
LDX ICIDNO 
LDA ICHID, X 
STA ICHIDZ 
JMP CIRTN2 



(DO IMPLIED CLOSE) 
IOCS INDEX 

GET ORIGINAL HANDLER 
RESTORE ZERO PAGE 
RETURN 



ID 



ERR LINE ADDR Bl B2 B3 B4 



CENTRAL INPUT/OUTPUT (CIO) 2.-1-1^ 



PAGE 



931 
932 










933 










934 


E569 


AS 


22 




935 


E56B 


25 


2A 




936 


E56D 


DO 


05 




937 










938 










939 


E56F 


AO 


83 




940 


E571 


4C 


IB 


E6 


941 










942 










943 


E574 


20 


3D 


E6 


944 


E577 


BO 


F8 




945 










946 










947 


E579 


AS 


28 




948 


E57B 


05 


29 




949 


E57D 


DO 


08 




950 


E57F 


20 


89 


E6 


951 


E582 


85 


2F 




952 


E584 


4C 


ID 


E6 


953 










954 


• 








955 


E587 


20 


89 


E6 


956 


E58A 


85 


2F 




957 


E58C 


30 


35 




958 


ESSE 


AO 


00 




959 


E590 


91 


24 




960 


E592 


20 


70 


E6 


961 


E59S 


AS 


22 




962 


E597 


29 


02 




963 


E599 


DO 


OC 




964 










965 










966 


E59B 


AS 


2F 




967 


E59D 


C9 


9B 




968 


E59F 


DO 


06 




969 


E5A1 


20 


63 


E6 


970 


E5A4 


4C 


C3 


E5 


971 










972 










973 


E5A7 


20 


63 


E6 


974 


E5AA 


DO 


DB 





. PAGE 

; READ — DO GET COMMANDS 
CIREAD: LDA ICCOMZ 
AND ICAXIZ 
BNE RCIIA 



GET COMMAND BYTE 
IS THIS READ LEGAL- 
YES 



; ILLEGAL READ 

LDY 
RCIIB: JMP 



— lOCB OPENED FOR WRITE ONLY 
#WRONLY ; ERROR CODE 
CIRTNl ; RETURN 



; COMPUTE AND CHECK ENTRY POINT 

RCIIA: JSR COMENT i COMPUTE ENTRY POINT 

BCS RCIIB ,00 IF ERROR IN COMPUTE 



GET RECORD OR CHARACTERS 

LDA ICBLLZ 

ORA ICBLLZ+1 

BNE RCI3 

JSR GOHAND 

ST A CIOCHR 

JMP CIRTN2 



; LOOP TO FILL BUFFER OR END RECORD 



; IS BUFFER LENGTH ZERO? 
iNO 



RCI3: 



JSR 
STA 
BMI 
LDY 
STA 
JSR 
LDA 
AND 
BNE 



GOHAND 

CIOCHR 

RCI4 

#0 

(ICBALZ), 

INCBFP 

ICCOMZ 

#2 

RCIl 



GO TO HANDLER TO GET BYTE 

SAVE BYTE 

END TRANSFER IF ERROR 

fPUT BYTE IN USER BUFFER 
; INCREMENT BUFFER POINTER 
; GET COMMAND CODE 
f IS IT GET RECORD? 
{NO 



CHECK FOR EOL ON TEXT RECORDS 



LDA 
CMP 
BNE 
JSR 
JMP 



CIOCHR 

#EOL 

RCIl 

DECBFL 

RCI4 



; CHECK BUFFER FULL 
RCIl: JSR DECBFL 
BNE RCI3 



GET BYTE 

IS IT AN EOL? 

NO 

YES, DECREMENT BUFFER LENGTH 

END TRANSFER 



; DECREMENT BUFFER LENGTH 
{CONTINUE IF NON ZERO 



ERR LINE 


ADDR 


Bl 


B2 


B3 


975 










976 










977 










978 










979 


E5AC 


A5 


22 




980 


E5AE 


29 


02 




981 


E5B0 


DO 


11 




982 










983 










984 


E5B2 


20 


89 


E6 


985 


E5B5 


85 


2F 




986 


E5B7 


30 


OA 




987 










988 










989 


E5B9 


A5 


2F 




990 


E5BB 


C9 


9B 




991 


E5BD 


DO 


F3 




992 










993 










994 


E5BF 


A9 


89 




995 


E5C1 


85 


23 




996 










997 










998 


E5C3 


20 


77 


E6 


999 


E5C6 


4C 


ID 


E6 



CENTRAL INPUT/OUTPUT (CIO) 2-7-79 

.PAGE 

BUFFER FULL, RECORD NOT ENDED 
DISCARD BYTES UNTIL END OF RECORD 



PAGE 



RCI2: 



LDA 


ICCOMZ 


AND 


#2 


BNE 


RCI4 



GET COMMAND BYTE 

IS IT GET CHARACTER? 

YES, END TRANSFER 



LOOP TO WAIT FOR EOL 



16: JSR 


GOHAND 


GET BYTE FROM HANDLER 


STA 


CIOCHR 


SAVE CHARACTER 


BMI 


RCI4 


GO IF ERROR 


TEXT RECORD, 


WAIT FOR EOL 




LDA 


CIOCHR 


GET GOT BYTE 


CMP 


#EOL 


IS IT EOL? 


BNE 


RCI6 


NO, CONTINUE 



; END OF RECORD, BUFFER FULL — SEND TRUNCATED RECORD MESSAGE 
RCIll: LDA #TRNRCD ; ERROR CODE 

STA ICSTAZ ; STORE IN lOCB 



; TRANSFER DONE 
RCI4: JSR SUBBFL 
JMP CIRTN2 



; SET FINAL BUFFER LENGTH 
; RETURN 



LINE 


ADDR 


Bl 


B2 


B3 B4 


1000 










1001 










1002 










1003 


E5C9 


A5 


22 




1004 


E5CB 


25 


2A 




1005 


E5CD 


DO 


05 




1006 










1007 










1008 


E5CF 


AO 


87 




1009 


ESDI 


4C 


IB 


E6 


1010 










1011 










1012 


E5D4 


20 


3D 


E6 


1013 


E5D7 


BO 


F8 




1014 










1015 










1016 


E5D9 


A5 


28 




1017 


E5DB 


05 


29 




1018 


E5DD 


DO 


06 




1019 


E5DF 


A5 


2F 




1020 


E5E1 


E6 


28 




1021 


E5E3 


DO 


06 




1022 










1023 










1024 


E5E5 


AO 


00 




1025 


E5E7 


Bl 


24 




1026 


E5E9 


85 


2F 




1027 


E5EB 


20 


89 


E6 


1028 


E5EE 


30 


25 




1029 


E5F0 


20 


70 


E6 


1030 










1031 










1032 


E5F3 


A5 


22 




1033 


E5F5 


29 


02 




1034 


E5F7 


DO 


OC 




1035 










1036 










1037 


E5F9 


A5 


2F 




1038 


E5FB 


C9 


9B 




1039 


E5FD 


DO 


06 




1040 


E5FF 


20 


63 


E6 


1041 


E602 


4C 


15 


E6 


1042 










1043 










1044 


E605 


20 


63 


E6 


1045 


E608 


DO 


DB 
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i WRITE — DO PUT COMMANDS 
CIWRIT: LDA ICCOMZ 
AND ICAXIZ 
BNE wen A 



GET COMMAND BYTE 

IS THIS WRITE LEGAL? 

YES 



i ILLEGAL WRITE — DEVICE OPENED FOR READ ONLY 

LDY #RDONLY ; ERROR CODE 
WCIIB: JMP CIRTNl .RETURN 

; COMPUTE AND CHECK ENTRY POINT 

wen A: JSR COMENT .COMPUTE HANDLER ENTRY POINT 
BCS WCIIB ;00 IF ERROR IN COMPUTE 



PUT RECORD OR CHARACTERS 



WCI3: 



WCI4: 



LDA 


ICBLLZ 


OR A 


ICBLLZ+1 


BNE 


WCI3 


LDA 


CIOCHR 


INC 


ICBLLZ 


BNE 


WCI4 


TRANSFER BYTES F 


LDY 


#0 


LDA 


<ICBALZ>, Y 


STA 


CIOCHR 


JSR 


GOHAND 


BMI 


WCI5 


JSR 


INCBFP 



CHECK FOR TEXT RECORD 
LDA ICCOMZ 
AND #2 
BNE WC I 1 



IS BUFFER LENGTH ZERO? 

NO 

GET CHARACTER 

SET BUFFER LENGTH=1 

THEN JUST TRANSFER ONE BYTE 



GET BYTE FROM BUFFER 

SAVE 

GO PUT BYTE 

END IF ERROR 

INCREMENT BUFFER POINTER 



GET COMMAND BYTE 
IS IT PUT RECORD? 
NO 



TEXT RECORD 
LDA 
CMP 
BNE 
JSR 
JMP 



CHECK FOR EOL TRANSFER 



CIOCHR 
#EOL 

wen 

DECBFL 
WCI5 



; CHECK FOR BUFFER EMPTY 
well: JSR DECBFL 
BNE WCI3 



GET LAST CHARACTER 

IS IT AN EOL? 

NO 

DECREMENT BUFFER LENGTH 

END TRANSFER 



.DECREMENT BUFFER LENGTH 
i CONTINUE IF NON ZERO 



ERR LINE ADDR Bl B2 B3 B4 



1046 










1047 










1048 










1049 










1050 


E60A 


AS 


22 




1051 


E60C 


29 


02 




1052 


E60E 


DO 


05 




1053 










1054 










1055 


E610 


A9 


9B 




1056 


E612 


20 


89 


E6 


1057 










1058 










1059 


E615 


20 


77 


E6 


1060 


E618 


4C 


ID 


E6 



CENTRAL INPUT/OUTPUT <CIO} 2-7-79 

.PAGE 

BUFFER EMPTY, RECORD NOT FILLED 
CHECK TYPE OF TRANSFER 



PAGE 
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WCI2: 



LDA 


ICCOMZ 


AND 


#2 


BNE 


WCI5 



GET COMMAND CODE 

IS IT PUT CHARACTER? 

YES. END TRANSFER 



PUT RECORD <TEXT), BUFFER EMPTY, SEND EOL 
LDA #EOL 
JSR GOHAND ; GO TO HANDLER 



; END PUT TRANSFER 
WCI5: JSR SUBBFL 
JMP CIRTN2 



,SET ACTUAL PUT BUFFER LENGTH 
; RETURN 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


CENTRAL INPUT/OUTPUT (CIO) 


2-7-79 


1061 












. PAGE 








1062 




















1063 










; CIO RETURNS 








1064 










; RETURNS WITH 


Y=STATUS 






1065 


E61B 


84 


23 




CIRTNl: 


STY 


ICSTAZ 




i SAVE STATUS 


1066 




















1067 










i RETURNS WITH 


STATUS STORED 


IN ICSTAZ 


1068 










} MOVE 


lOCB IN 


ZERO PAGE 


BACK TO USER AREA 


1069 


E61D 


A4 


2E 




CIRTN2: 


LDY 


ICIDNO 




GET lOCB INDEX 


1070 


E61F 


89 


44 


03 




LDA 


ICBAL, Y 




- 


1071 


E622 


85 


24 






STA 


ICBALZ 




RESTORE USER BUFFER POIN 


1072 


E624 


B9 


45 


03 




LDA 


ICBAH. Y 






1073 


E627 


85 


25 






STA 


ICBAHZ 






1074 


E629 


A2 


00 






LDX 


#0 




LOOP COUNT AND INDEX 


1075 


E62B 


B5 


20 




C1RT3: 


LDA 


lOCBAS, X 




ZERO PAGE 


1076 


E62D 


99 


40 


03 




STA 


lOCB, Y 




TO USER AREA 


1077 


E630 


E8 








INX 








1078 


E631 


C8 








I NY 








1079 


E632 


EO 


OC 






CPX 


#12 




12 BYTES 


1080 


E634 


90 


F5 






BCC 


CIRT3 






1081 










; 










1082 










; RESTORE A, X, 


fy. Y 






1083 


E636 


A5 


2F 






LDA 


CIOCHR 




GET LAST CHARACTER 


1084 


E638 


A6 


2E 






LDX 


ICIDNO 




lOCB INDEX 


1085 


E63A 


A4 


23 






LDY 


ICSTAZ 




GET STATUS AND SET FLAGS 


1086 


E63C 


60 








RTS 






RETURN TO USER 



PAGE 
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ERR LINE ADDR Bl B2 B3 B4 



1087 








1088 








1089 








1090 








1091 








1092 








1093 


E63D 


A4 


20 


1094 


E63F 


CO 


22 


1095 


E641 


90 


04 


1096 








1097 








1098 


E643 


AO 


85 


1099 


E645 


BO 


IB 


1100 








1101 








1102 


E647 


B9 


IB 03 


1103 


E64A 


85 


2C 


1104 


E64C 


B9 


IC 03 


1105 


E64F 


85 


2D 


1106 


E651 


A4 


17 


1107 


E653 


B9 


C6 E6 


1108 


E656 


A8 




1109 


E657 


Bl 


2C 


1110 


E659 


AA 




1111 


E65A 


C8 




1112 


E65B 


Bl 


2C 


1113 


E65D 


85 


2D 


1114 


E65F 


86 


2C 


1115 


E661 


18 




1116 


E662 


60 




1117 








1118 








1119 








1120 








1121 


E663 


C6 


28 


1122 


E665 


A5 


28 


1123 


E667 


C9 


FF 


1124 


E669 


DO 


02 


1125 


E66B 


C6 


29 


1126 


E66D 


05 


29 


1127 


E66F 


60 




1128 








1129 








1130 








1131 


E670 


E6 


24 


1132 


E672 


DO 


02 


1133 


E674 


E6 


25 


1134 


E676 


60 




1135 








1136 








1137 








1138 


E677 


A6 


2E 


1139 


E679 


38 




1140 


E67A 


BD 


48 03 
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CIO SUBROUTINES 

COMENT ~ CHECK AND COMPUTE HANDLER ENTRY POINT 
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COMENT: 



LDY 
CPY 
BCC 



ICHIDZ 

#MAXDEV-H 

COMl 



GET HANDLER INDEX 
IS IT A LEGAL INDEX- 
YES 



ILLEGAL HANDLER INDEX MEANS DEVICE NOT OPEN FOR OPERATION 
LDY #NOTOPN /ERROR CODE 
BCS COM2 ; RETURN 



i USE HANDLER 
COMl: LDA 
STA 
LDA 
STA 
LDY 
LDA 
TAY 
LDA 
TAX 
I NY 
LDA 
STA 
STX 
CLC 
COM2: RTS 



ADDRESS TABLE AND COMMAND TABLE TO GET VECTOR 



HATABS+1, Y 
ICSPRZ 
HATABS+2. Y 
ICSPRZ+1 
ICCOMT 
COMTAB-3, Y 



GET LOW BYTE OF ADDRESS 
AND SAVE IN POINTER 
GET HI BYTE OF ADDRESS 

; GET COMMAND CODE 
; GET COMMAND OFFSET 



( ICSPRZ), Y ; GET LOW BYTE OF VECTOR FROM 
; HANDLER ITSELF AND SAVE 

( ICSPRZ), Y ; GET HI BYTE OF VECTOR 

ICSPRZ+1 

ICSPRZ ;SET LO BYTE 

; SHOW NO ERROR 



DECBFL — DECREMENT BUFFER LENGTH DOUBLE BYTE 



Z FLAG = ON RETURN 



DECBFL: DEC 
LDA 
CMP 
BNE 
DEC 

DECBFl: ORA 
RTS 



INCBFP — 

INCBFP: INC 

BNE 

INC 

INCBFl: RTS 



ICBLLZ 

ICBLLZ 

#*FF 

DECBFl 

ICBLLZ+1 

ICBLLZ+1 



IF LENGTH = AFTER DECREMENT 
DECREMENT LOW BYTE 
CHECK IT 

DID IT 00 BELOW? 
NO 

DECREMENT HI BYTE 
SET Z IF BOTH ARE ZERO 



INCREMENT WORKING BUFFER POINTER 



ICBALZ 
INCBFl 
ICBALZ+1 



BUMP LOW BYTE 
GO IF NOT ZERO 
ELSE, BUMP HI BYTE 



SUBBFL — SET BUFFER LENGTH = BUFFER LENGTH - WORKING BYTE COUNT 
SUBBFL: LDX ICIDNO ; GET lOCB INDEX 
SEC 
LDA ICBLL, X ; GET LOW BYTE OF INITIAL LENGTH 



ERR LINE 


ADDR 


Bi 


B2 


B3 B4 


1141 


E67D 


E5 


28 




1142 


E67F 


85 


28 




1143 


E681 


6D 


49 


03 


1144 


E684 


E5 


29 




1145 


E686 


85 


29 




1146 


E688 


60 






1147 










1148 










1149 










1150 










1151 


E689 


AO 


92 




1152 


E68B 


20 


93 


E6 


1153 


E68E 


84 


23 




1154 


E690 


CO 


00 




1155 


E692 


60 






1156 










1157 










1158 


E693 


AA 






1159 


E694 


A5 


2D 




1160 


E696 


48 






1161 


E697 


A5 


2C 




1162 


E699 


48 






1163 


E69A 


8A 






1164 


E69B 


A6 


2E 




1165 


E69D 


60 







CENTRAL INPUT /OUTPUT (CIO) 2-7-79 



PAGE 



27 



SBC 


ICBLLZ 


; SUBTRACT FINAL LOW BYTE 


STA 


ICBLLZ 


i AND SAVE BACK 


LDA 


ICBLH, X 


iOET HI BYTE 


SBC 


ICBLLZ+1 




STA 


ICBLHZ 




RTS 







GOHAND — GO INDIRECT TO A DEVICE HANDLER 

Y= STATUS ON RETURN, N FLAG=1 IF ERROR ON RETURN 



GOHAND: LDY 


#FNCNOT 


PREPARE NO FUNCTION STATI 


JSR 


CI JUMP 


USE THE INDIRECT 


JUMP 


STY 


ICSTAZ 


SAVE STATUS 




CPY 


#0 


AND SET N FLAG 




RTS 








i INDIRECT JUMP 


TO HANDLER BY PAUL'S METHOD 




CI JUMP: TAX 




SAVE A 




LDA 


ICSPRZ+1 


GET JUMP ADDRESS 


HI BYTE 


PHA 




PUT ON STACK 




LDA 


ICSPRZ 


GET JUMP ADDRESS 


LO BYTE 


PHA 




PUT ON STACK 




TXA 




RESTORE A 




LDX 


ICIDNO 


GET lOCB INDEX 




RTS 




GO TO HANDLER INDIRECTLY 



ERR LINE 


ADDR 


Bl 


B2 B3 


1166 








1167 








1168 








1169 








1170 








1171 


E69E 


AO 


00 


1172 


E6A0 


Bl 


24 


1173 


E6A2 


FO 


OC 


1174 


E6A4 


AO 


21 


1175 


E6A6 


D9 


lA 03 


1176 


E6A9 


FO 


OA 


1177 


E6AB 


88 




1178 


E6AC 


88 




1179 


E6AD 


88 




1180 


E6AE 


10 


F6 


1181 








1182 








1183 


E6B0 


AO 


82 


1184 


E6B2 


38 




1185 


E6B3 


BO 


13 


1186 








1187 








1188 


E6B5 


98 




1189 


E6B6 


85 


20 


1190 


E6B8 


38 




1191 


E6B9 


AO 


01 


1192 


E6BB 


Bl 


24 


1193 


E6BD 


E9 


30 


1194 


E6BF 


C9 


OA 


1195 


E6C1 


90 


02 


1196 


E6C3 


A9 


01 


1197 


E6C5 


85 


21 


1198 


E6C7 


18 




1199 








1200 








1201 


E6C8 


60 





CENTRAL INPUT/OUTPUT (CIO) 2-7-79 PAGE 

. PAGE 

DEVSRC — DEVICE SEARCH, FIND DEVICE IN HANDLER ADDRESS TABLE 

LOOP TO FIND DEVICE 

GET DEVICE NAME FROM USER 

INITIAL COMPARE INDEX 
IS THIS THE DEVICE? 
YES 

ELSE, POINT TO NEXT DEVICE NAME 

CONTINUE FOR ALL DEVICES 



ERROR CODE 
SHOW ERROR 
AND RETURN 



i FOUND DEVICE, SET ICHID, ICDNO, AND INIT DEVICE 
DEVS2: TYA 

SAVE HANDLER INDEX 



GET DEVICE NUMBER (DRIVE NUMBER) 

SUBTRACT ASCII ZERO 

IS NUMBER IN RANGE? 

YES 

NO, DEFAULT TO ONE 

SAVE DEVICE NUMBER 

SHOW NO ERROR 



28 



DEVSRC: LDY 


#0 


LDA 


(ICBALZ), Y 


BEQ 


CIERR2 


LDY 


#MAXDEV 


DEVSl: CMP 


HATABS, Y 


BEQ 


DEVS2 


DEY 




DEY 




DEY 




BPL 


DEVSl 


; NO DEVICE 


FOUND, DECLARE 


CIERR2: LDY 


#NONDEV 


SEC 




BCS 


DEVS4 





STA 


ICHIDZ 




SEC 






LDY 


#1 




LDA 


(ICBALZ), Y 




SBC 


#ASCZER 




CMP 


#*A 




BCC 


DEVS3 




LDA 


#1 


DEVS3: 


STA 
CLC 


ICDNOZ 


; RETURN 




DEVS4: 


RTS 





ERR LINE ADDR Bl B2 B3 B4 



1202 












1203 












1204 












1205 












1206 












1207 












1208 












1209 


E6C9 


00 


04 


04 


04 


1210 


E6CD 


04 


06 


06 


06 


1211 


E6D1 


06 


02 


08 


OA 


1212 


022F 










1213 


E6D5 










1214 












1215 


0014 


00 
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CIO ROM TABLES 

COMMAND TABLE 

MAPS EACH COMMAND TO OFFSET FOR APPROPRIATE VECTOR IN HANDLER 
COMTAB: BYTE 0,4,4,4,4,6.6/6,6,2,8.10 



LENGTH =»-CIOINT 
CRNTPl =» 

»=*14 
CIOSPR: .BYTE INTORG-CRNTPl 



29 



•GCIOL IS TOO LONG 



ERR LINE 


ADDR 


ei 


B2 


B3 B4 


1216 










1217 










1218 










1219 


0006 








1220 










1221 










1222 










1223 










1224 


E912 


40 


ED 


E8 


1225 










1226 


E45C 


4C 


ED 


E8 


1227 


E45F 


4C 


AE 


E7 


1228 


E462 


4C 


05 


E9 


1229 










1230 


E46B 


4C 


D5 


E6 


1231 










1232 










1233 










1234 


E480 


90 


E7 




1235 


E482 


8F 


E7 




1236 


E484 


8F 


E7 




1237 


E486 


8F 


E7 




1238 










1239 


E488 








1240 


E490 


8F 


E7 




1241 


E492 


8F 


E7 




1242 


E494 


8F 


E7 




1243 


E496 


06 


E7 




1244 


E498 


00 


00 


00 00 


1245 


E49C 


00 


00 


00 00 


1246 


E4A0 


00 


00 




1247 


E4A2 


AE 


E7 




1248 


E4A4 


05 


E9 




1249 










1250 










1251 










1252 


900C 


A9 


E6 




1253 


900E 


8D 


F9 


FF 


1254 


9011 


A9 


F3 




1255 


9013 


8D 


F8 


FF 


1256 


9016 


A9 


E7 




1257 


9018 


8D 


FB 


FF 


1258 


901B 


A9 


91 




1259 


901D 


8D 


FA 


FF 


1260 


9020 


60 
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. TITLE ' INTERRUPT HANDLER ' 
; LIVES ON DKl: INTHV. SRC 
SRTIM2 = 6 i SECOND REPEAT INTERVAL 

THIS IS TO MAKE DOS 2 WORK WHICH USED AN ABSOLUTE ADDRESS 

*=*E912 

JMP SETVBL 

*=SETVBV 

JMP SETVBL 

JMP SYSVBL 

JMP XITVBL 

*=INTINV 

JMP IHINIT 

*=VCTABL+ INTABS-VDSLST 



PAGE 



30 



. WORD 


SYRTI 


VDSLST 


. WORD 


SYIRQB 


VPRCED 


. WORD 


SYIRQB 


V INTER 


. WORD 


SYIRQB 


VBREAK 


. RES 


8 




. WORD 


SYIRQB 


VTIMRl 


. WORD 


SYIRQB 


VTIMR2 


. WORD 


SYIRQB 


VTIMR4 


. WORD 


SYIRQ 


VIMIRQ 


.WORD 


0, 0, 0. 0, 


CDTMV1~4 


.WORD 


SYSVBL 


VVBLKI 


. WORD 


XITVBL 


VVBLKD 


*=*900C 






LDA 


#PIRQH 


SET UP R 


STA 


*FFF9 




LDA 


#PIRQL 




STA 


*FFF8 




LDA 


#PNMIH 




STA 


*FFFB 




LDA 


#PNMIL 




STA 


*FFFA 




RTS 







;SET UP RAM VECTORS FOR LINBUG VERSION 



ERR LINE 


ADDR 


Bl 


B2 


B3 


1261 










1262 










1263 










1264 










1265 










1266 










1267 










1268 










1269 


E6D5 


A9 


40 




1270 


E6D7 


8D 


OE 


D4 


1271 


E6DA 


A9 


38 




1272 


E6DC 


8D 


02 


03 


1273 


E6DF 


8D 


03 


D3 


1274 


E6E2 


A9 


00 




1275 


E6E4 


8D 


00 


D3 


1276 


E6E7 


8D 


01 


D3 


1277 


E6EA 


A9 


3C 




1278 


E6EC 


8D 


02 


D3 


1279 


E6EF 


8D 


03 


D3 


1280 


E6F2 


60 






1281 


E6F3 


6C 


16 


02 


1282 


E6F6 


80 






1283 


E6F7 


40 






1284 


E6F8 


04 






1285 


E6F9 


02 






1286 


E6FA 


01 






1287 


E6FB 


08 






1288 


E6FC 


10 






1289 


E6FD 


20 






1290 


E6FE 








1291 










1292 


E6FE 


36 






1293 


E6FF 


08 






1294 


E700 


14 






1295 


E701 


12 






1296 


E702 


10 






1297 


E703 


OE 






1298 


E704 


OC 






1299 


E705 


OA 






1300 


E706 








1301 


E706 


48 






1302 


E707 


AD 


OE 


D2 


1303 


E70A 


29 


20 




1304 


E70C 


DO 


OD 




1305 


E70E 


A9 


DF 




1306 


E710 


8D 


OE 


D2 


1307 


E713 


A5 


10 




1308 


E715 


8D 


OE 


D2 


1309 


E718 


6C 


OA 


02 


1310 


E71B 


8A 






1311 


E71C 


48 






1312 


E71D 


A2 


06 




1313 


E71F 


BD 


F6 


E6 


1314 


E722 


EO 


05 





INTERRUPT HANDLER 
.PAGE 
IRQ HANDLER 



JUMP THRU IMMEDIATE IRQ VECTORi WHICH ORDINARILY POINTS TO 
SYSTEM IRQ: DETERMINE ?< CLEAR CAUSE. JUMP THRU SOFTWARE VECTOR. 
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»=INTORG 
IHINIT: LDA 

STA 

LDA 

STA 

STA 

LDA 

STA 

STA 

LDA 

STA 

STA 

RTS 
PIRQ: JMP 
CMPTAB: .BYTE 

. BYTE 

. BYTE 

. BYTE 

. BYTE 

. BYTE 

. BYTE 

. BYTE 



#»40 

NMIEN 

#$38 

PACTL 

PBCTL 

#0 

PORTA 

PORTB 

#*3C 

PACTL 

PBCTL 

(VIMIRQ) 

*80 

*40 

*04 

*02 

*01 

*08 

*10 

*20 



VBL ON BUF DLIST OFF*«*FOR NOW*** 
ENABLE DISPLAY LIST, VERTICAL BLANK 
LOOK AT DATA DIRECTION REGISTERS IN PIA 



; MAKE ALL INPUTS 



.BACK TO PORTS 



BREAK KEY 

KEY STROKE 

TIMER 4 

TIMER 2 

TIMER 1 

SERIAL OUT COMPLETE 

SERIAL OUT READY 

SERIAL IN READY 



; THIS IS A TABLE OF OFFSETS INTO PAGE 2. THEY POINT TO 



ADRTAB: .BYTE 
. BYTE 
. BYTE 
. BYTE 
. BYTE 
. BYTE 
. BYTE 
. BYTE 

SYIRQ: PHA 
LDA 
AND 
BNE 
LDA 
STA 
LDA 
STA 
JMP 

SYIRQ2: TXA 
PHA 
LDX 

LOOPM: LDA 
CPX 



BRKKY-INTABS 

VKEYBD-INTABS 

VTIMR4-INTABS 

VTIMR2-INTABS 

VTIMRl-INTABS 

VSEROC-INTABS 

VSEROR-INTABS 

VSERIN-INTABS 



IRQST 

#*20 

SYIRQ2 

#*DF 

IRQEN 

POKMSK 

IRQEN 

(VSERIN) 



#$6 

CMPTAB, X 
#5 



; SAVE ACCUMULATOR 

; CHECK FOR SERIAL IN 



MASK ALL OTHERS 



PUT X INTO ACC 

SAVE X ONTO STACK 

START WITH SIX OFFSET 

LOAD MASK 

CHECK TO SEE IF COMPLETE IS SET 



LINE 


ADDR 


Bl 


B2 


B3 B4 


INTERRUPT HANDLER 


1315 


E724 


DO 


04 






BNE 


L00PM2 


1316 


E726 


25 


10 






AND 


POKMSK 


1317 


E728 


FO 


05 






BEQ 


LL 


1318 


E72A 


2C 


OE 


D2 


L00PM2: 


BIT 


IRQST 


1319 


E72D 


FO 


06 






BEQ 


JMPP 


1320 


E72F 


CA 






LL: 


DEX 




1321 


E730 


10 


ED 






BPL 


LOOPM 


1322 


E732 


4C 


62 


E7 




JMP 


SYIRQ8 


1323 


E735 


49 


FF 




JMPB: 


EOR 


#*FF 


1324 


E737 


8D 


OE 


D2 




STA 


IRQEN 


1325 


E73A 


A5 


10 






LDA 


POKMSK 


1326 


E73C 


8D 


OE 


D2 




STA 


IRQEN 


1327 


E73F 


BD 


FE 


E6 




LDA 


ADR TAB, X 


1328 


E742 


AA 








TAX 




1329 


E743 


BD 


00 


02 




LDA 


INTABS, X 


1330 


E746 


8D 


8C 


02 




STA 


JVECK 


1331 


E749 


BD 


01 


02 




LDA 


INTABS+1, X 


1332 


E74C 


SD 


8D 


02 




STA 


JVECK+1 


1333 


E74F 


68 








PLA 




1334 


E750 


AA 








TAX 




1335 


E751 


6C 


8C 


02 




JMP 


(JVECK) 


1336 


E754 


A9 


00 




BRKKY2: 


LDA 


#0 


1337 


E756 


85 


11 






STA 


BRKKEY 


1338 


E758 


8D 


FF 


02 




STA 


SSFLAG 


1339 


E75B 


8D 


FO 


02 




STA 


CRSINH 


1340 


E75E 


85 


4D 






STA 


ATRACT 


1341 


E760 


68 








PLA 




1342 


E761 


40 








RTI 




1343 


E762 


68 






SYIRQ8: 


PLA 




1344 


E763 


AA 








TAX 




1345 


E764 


2C 


02 


D3 




BIT 


PACTL 


1346 


E767 


10 


06 






BPL 


SYIRQ9 


1347 


E769 


AD 


00 


D3 




LDA 


PORTA 


1348 


E76C 


6C 


02 


02 




JMP 


(VPRCED) 


1349 


E76F 


2C 


03 


D3 


SYIRQ9: 


BIT 


PBCTL 


1350 


E772 


10 


06 






BPL 


SYIRQA 


1351 


E774 


AD 


01 


D3 




LDA 


PORTB 


1352 


E777 


6C 


04 


02 




JMP 


(VINTER) 


1353 


E77A 


68 






SYIRQA: 


PLA 




1354 


E77B 


8D 


8C 


02 




STA 


JVECK 


1355 


E77E 


68 








PLA 




1356 


E77F 


48 








PHA 




1357 


E780 


29 


10 






AND 


#*10 


1358 


E782 


FO 


07 






BEQ 


SYRTI2 


1359 


E784 


AD 


8C 


02 




LDA 


JVECK 


1360 


E787 


48 








PHA 




1361 


E788 


6C 


06 


02 




JMP 


(VBREAK) 


1362 


E78B 


AD 


8C 


02 


SYRTI2: 


LDA 


JVECK 


1363 


E78E 


48 








PHA 




1364 


E78F 


68 






SYIRQB: 


PLA 




1365 


E790 


40 






SYRTI: 


RTI 
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; IS THIS INTERUPT ENABLED? 

; IS IT THE INTERUPT? 

NO DEC X AND TRY NEXT MASK 
IF NOT NEG GOTO LOOPM 
DONE BUT NO INTERUPT 
COMPLEMENT MASK 
ENABLE ALL OTHERS 

GET POKE MASK 

ENABLE THOSE IN POKE MASK 



GET ADDRESS LOW PART 

PUT IN VECTOR 

GET ADDRESS HIGH PART 

PUT IN VECTOR HIGH PART 

PULL X REGISTER FROM STACK 

PUT IT INTO X 

JUMP TO THE PROPER ROUTINE 

BREAK KEY ROUTINE 

SET BREAK KEY FLAG 

START/STOP FLAG 

CURSOR INHIBIT 

TURN OFF ATRACT MODE 

EXIT FROM INT 



/ PROCEED ***I GUESS*** 
CLEAR INT STATUS BIT 
I INTERRUPT ***I GUESS*** 
i CLEAR INT STATUS 



;B BIT OF P REGISTER 



; UNIDENTIFIED INTERRUPT, JUST RETURN. 



LINE 


ADDR 


Bl 


B2 


B3 


1366 










1367 










1368 










1369 










1370 










1371 










1372 


E791 


2C 


OF 


D4 


1373 


E794 


10 


03 




1374 


E796 


6C 


00 


02 


1375 


E799 


48 






1376 


E79A 


AD 


OF 


D4 


1377 


E79D 


29 


20 




1378 


E79F 


FO 


03 




1379 


E7A1 


4C 


74 


E4 


1380 


E7A4 


8A 






1381 


E7A5 


48 






1382 


E7A6 


98 






1383 


E7A7 


48 






1384 


E7A8 


8D 


OF 


D4 


1385 


E7AB 


6C 


22 


02 



INTERRUPT HANDLER 
. PAGE 
NMI HANDLER 
DETERMINE CAUSE AND JUMP THRU VECTOR 
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PNMI: 


BIT 


NMI ST 




BPL 


PNMIl 




JMP 


(VDSLST) 


PNMIl: 


PHA 






LDA 


NMI ST 




AND 


#*20 




BEQ 


#+5 




JMP 


WARMSV 




TXA 






PHA 






TYA 






PHA 






STA 


NMI RES 




JMP 


(WBLKI) 



SEE IF DISPLAY LIST 



; SEE IF RESET 

; 00 THRU WARM START JUMP 
i SAVE REGISTERS 



; RESET INTERRUPT STATUS 
; JUMP THRU VECTOR 



ERR LINE ADDR Bl B2 B3 B4 



INTERRUPT HANDLER 
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1386 










1387 










1388 










1389 










1390 










1391 










1392 










1393 


E7AE 


E6 


14 




1394 


E7B0 


DO 


08 




1395 


E7B2 


E6 


4D 




1396 


E7B4 


E6 


13 




1397 


E7B6 


DO 


02 




1398 


E7B8 


E6 


12 




1399 


E7BA 


A9 


FE 




1400 


E7BC 


A2 


00 




1401 


E7BE 


A4 


4D 




1402 


E7C0 


10 


06 




1403 


E7C2 


85 


4D 




1404 


E7C4 


A6 


13 




1405 


E7C6 


A9 


F6 




1406 


E7C8 


85 


4E 




1407 


E7CA 


86 


4F 




1408 


E7CC 


A2 


00 




1409 


E7CE 


20 


DO 


E8 


1410 


E7D1 


DO 


03 




1411 


E7D3 


20 


CA 


E8 


1412 


E7D6 


A5 


42 




1413 


E7D8 


DO 


08 




1414 


E7DA 


BA 






1415 


E7DB 


BD 


04 


01 


1416 


E7DE 


29 


04 




1417 


E7E0 


FO 


03 




1418 


E7E2 


4C 


05 


E9 


1419 


E7E5 


AD 


OD 


D4 


1420 


E7E8 


8D 


35 


02 


1421 


E7EB 


AD 


OC 


D4 


1422 


E7EE 


8D 


34 


02 


1423 


E7F1 


AD 


31 


02 


1424 


E7F4 


8D 


03 


D4 


1425 


E7F7 


AD 


30 


02 


1426 


E7FA 


8D 


02 


D4 


1427 


E7FD 


AD 


2F 


02 


1428 


E800 


8D 


00 


D4 


1429 


E803 


AD 


6F 


02 


1430 


E806 


8D 


IB 


DO 


1431 


E809 


A2 


08 




1432 


E80B 


8E 


IF 


DO 


1433 


E80E 


58 






1434 


E80F 


BD 


CO 


02 


1435 


E812 


45 


4F 




1436 


E814 


25 


4E 




1437 


E816 


9D 


12 


DO 


1438 


E819 


CA 






1439 


E81A 


10 


F2 





. PAGE 

SYSTEM VBLANK ROUTINE 

INC FRAME COUNTER. PROCESS COUNTDOWN TIMERS. EXIT IF I WAS SET. 
SET DLISTL, DLISTH, DMACTL FROM RAM CELLS. DO SOFTWARE REPEAT. 



CLEAR 



SYSVBL: 



SYSVBl: 



VBATRA: 



SYSVB2: 



XXIT: 
SYSVB3: 



SCOLLP: 



INC 
BNE 
INC 
INC 
BNE 
INC 
LDA 
LDX 
LDY 
BPL 
STA 
LDX 
LDA 
STA 
STX 
LDX 
JSR 
BNE 
JSR 
LDA 
BNE 
TSX 
LDA 
AND 
BEQ 
JMP 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDX 
STX 
CLI 
LDA 
EOR 
AND 
STA 
DEX 
BPL 



RTCLOK+2 

SYSVB 1 

ATRACT 

RTCLOK+1 

SYSVBl 

RTCLOK 

#*FE 

#0 

ATRACT 

VBATRA 

ATRACT 

RTCLOK+1 

#*F6 

DRKMSK 

COLRSH 

#0 

DCTIMR 

SYSVB2 

JTIMRl 

CRITIC 

XXIT 

*104. X 

#*04 

SYSVB3 

XITVBL 

PENV 

LPENV 

PENH 

LPENH 

SDLSTH 

DLISTH 

SDLSTL 

DLISTL 

SDMCTL 

DMACTL 

©PRIOR 

PRIOR 

#*08 

CONSOL 

PCOLRO/ X 
COLRSH 
DRKMSK 
COLPMO/ X 

SCOLLP 



; INC FRAME COUNTER 

; INCREMENT ATRACT (CAUSES ATRACT WHEN MINUS) 



•CATRACT3 SET DARK MASK TO NORMAL 

SET COLRSH TO NORMAL 

TEST ATRACT FOR NEGATIVE 

WHILE POSITIVE. DONT GO INTO ATRACT 

IN ATRACT. SO STAY BY STA *FE 

COLOR SHIFT FOLLOWS RTCLOK-H 

SET DARK MASK TO DARK 



POINT TO TIMERl 
GO DECREMENT TIMERl 
BRANCH IF STILL COUNTING 
GO JUMP TO ROUTINE 

GO IF CRITICAL SET 

SEE IF I WAS SET 

GET STACKED P 

I BIT 

BRANCH IF OK 

I WAS SET. EXIT 



{GLOBAL PRIOR 

i TURN OFF KEYBOARD SPEAKER 

DISABLE INTERUPTS 

LOAD COLOR REGISTERS FROM RAM 

DO COLOR SHIFT 

AND DARK ATRACT 



LINE 


ADDR 


Bl 


B2 


B3 B4 


1440 


E81C 


AO 


F4 


02 


1441 


E81F 


8D 


09 


D4 


1442 


E822 


AD 


F3 


02 


1443 


E825 


8D 


01 


D4 


1444 


E828 


A2 


02 




1445 


E82A 


20 


DO 


E8 


1446 


E82D 


DO 


03 




1447 


E82F 


20 


CD 


E8 


1448 


E832 


A2 


02 




1449 


E834 


E8 






1450 


E835 


E8 






1451 


E836 


BD 


18 


02 


1452 


E839 


ID 


19 


02 


1453 


E83C 


FO 


06 




1454 


E83E 


20 


DO 


E8 


1455 


E841 


9D 


26 


02 


1456 


E844 


EO 


08 




1457 


E846 


DO 


EC 




1458 










1459 


E848 


AD 


OF 


D2 


1460 


E84B 


29 


04 




1461 


E84D 


FO 


08 




1462 










1463 


E84F 


AD 


Fl 


02 


1464 


E852 


FO 


03 




1465 


E854 


CE 


Fl 


02 


1466 










1467 


E857 


AD 


2B 


02 


1468 


E85A 


FO 


17 




1469 


E85C 


AD 


OF 


D2 


1470 


E85F 


29 


04 




1471 


E861 


DO 


60 




1472 


E863 


CE 


2B 


02 


1473 


E866 


DO 


OB 




1474 










1475 


E868 


A9 


06 




1476 


E86A 


8D 


2B 


02 


1477 


E86D 


AD 


09 


D2 


1478 


E870 


8D 


FC 


02 


1479 










1480 


E873 


AO 


01 




1481 


E875 


A2 


03 




1482 


ES77 


B9 


00 


D3 


1483 


E87A 


4A 






1484 


E87B 


4A 






1485 


E87C 


4A 






1486 


E87D 


4A 






1487 


E87E 


9D 


78 


02 


1488 


E881 


CA 






1489 


E882 


B9 


00 


D3 


1490 


E885 


29 


OF 




1491 


E887 


9D 


78 


02 


1492 


E88A 


CA 






1493 


E88B 


88 







INTERRUPT HANDLER 





LDA 


CHBAS 








STA 


CHBASE 








LDA 


CHACT 








STA 


CHACTL 








LDX 


#2 




i POINT TO TIMER I 




JSR 


DCTIMR 








BNE 


SYSVB4 




; IF DIDNT GO ZER( 




JSR 


JTIMR2 




;G0 JUMP TO TIMEI 


SYSVB4: 


LDX 


#2 




{RESTORE X 


SYSVBB: 


INX 
INX 










LDA 


CDTMVl, 


X 






OR A 


CDTMVl+1, X 






BEQ 


SYSVBA 








JSR 


DCTIMR 




.DECREMENT AND S 




STA 


CDTMF3- 


■4, X 




SYSVBA: 


CPX 


#8 




iSEE IF DONE ALL 




BNE 


SYSVBB 




iLOOP 



IF NONZERO 



CHECK. DEBOUNCE COUNTER 

LDA SKSTAT 

AND #*04 

BEQ SYVB6A 
KEY UP SO COUNT IT 

LDA KEYDEL 

BEQ SYVB6A 

DEC KEYDEL 
CHECK SOFTWARE REPEAT TIMER 



KEY DOWN BIT 
IF KEY DOWN 

KEY DELAY COUNTER 

IF COUNTED DOWN ALREADY 

COUNT IT 



SYVB6A: 



LDA 
BEQ 
LDA 
AND 
BNE 
DEC 
BNE 



SRTIMR 

SYSVB7 

SKSTAT 

#*04 

SYSVB6 

SRTIMR 

SYSVB7 



i DOESN'T COUNT 

CHECK KEY DOWN BIT 
BRANCH IF NO LONGER DOWN 
COUNT FRAME OF KEY DOWN 
BRANCH IF NOT RUN OUT 



TIMER RAN OUT - RESET AND SIMULATE KEYBOARD IRQ 



LDA 
STA 
LDA 
STA 



#SRTIM2 
SRTIMR 
KBCODE 
CH 



TIMER VALUE 
SET TIMER 
GET THE KEY 
PUT INTO CH 



READ GAME CONTROLLERS 



SYSVB7: LDY 
LDX 

STLOOP : LDA 
LSR 
LSR 
LSR 
LSR 
STA 
DEX 
LDA 
AND 
STA 
DEX 
DEY 



#1 

#3 

PORTA, Y 

A 

A 

A 

A 

STICKO, X 

PORTA. Y 
#*F 
STICKO. X 



STORE JOYSTICK 



STORE JOYSTICK 



ERR LINE 


ADDR 


Bl 


B2 


B3 


1494 


E88C 


10 


E9 




1495 










1496 


E88E 


A2 


03 




1497 


E890 


BD 


10 


DO 


1498 


E893 


9D 


84 


02 


1499 


E896 


BD 


00 


D2 


1500 


E899 


9D 


70 


02 


1501 


E89C 


BD 


04 


D2 


1502 


E89F 


9D 


74 


02 


1503 


ESA2 


CA 






1504 


E8A3 


10 


EB 




1505 


E8A5 


8D 


OB 


D2 


1506 










1507 


E8A8 


A2 


06 




1508 


E8AA 


AC 


03 




1509 


E8AC 


B9 


78 


02 


1510 


E8AF 


4A 






1511 


E8B0 


4A 






1512 


E8B1 


4A 






1513 


E8B2 


9D 


7D 


02 


1514 


E8B5 


A9 


00 




1515 


E8B7 


2A 






1516 


E8B8 


9D 


7C 


02 


1517 


E8BB 


CA 






1518 


E8BC 


CA 






1519 


E8BD 


88 






1520 


E8BE 


10 


EC 




1521 










1522 


E8C0 


6C 


24 


02 


1523 


00E8 








1524 


0073 








1525 


E8C3 


A9 


00 




1526 


E8G5 


8D 


2B 


02 


1527 


E8C8 


FO 


A9 




1528 


E8CA 


6C 


26 


02 


1529 


E8CD 


6C 


28 


02 


1530 










1531 










1532 










1533 










1534 










1535 


E8D0 


BC 


18 


02 


1536 


E8D3 


DO 


08 




1537 


E8D5 


BC 


19 


02 


1538 


E8D8 


FO 


10 




1539 


E8DA 


DE 


19 


02 


1540 


E8DD 


DE 


18 


02 


1541 


E8E0 


DO 


08 




1542 


E8E2 


BC 


19 


02 


1543 


E8E5 


DO 


03 




1544 


E8E7 


A9 


00 




1545 


E8E9 


60 






1546 


E8EA 


A9 


FF 




1547 


E8EC 


60 







INTERRUPT HANDLER 
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BPL 



STLOOP 





LDX 


#3 


STRL: 


LDA 


TRIGO, X 




STA 


STRIGO, X 




LDA 


POTO, X 




STA 


PADDLO, X 




LDA 


P0T4, X 




STA 


PADDL4, X 




DEX 






BPL 


STRL 




STA 


POTGO 




LDX 


#6 




LDY 


#3 


PTRLP; 


LDA 


STICKO, Y 




LSR 


A 




LSR 


A 




LSR 


A 




STA 


PTRIGl, X 




LDA 


#0 




ROL 


A 




STA 


P TRIGO, X 




DEX 






DEX 






DEY 






BPL 


PTRLP 




JMP 


(VVBLKD) 


SV7H 


=s 


SYSVB7/2 


SV7L 


= 


(-256)*S 


SYSVB6: 


LDA 


#0 




STA 


SRTIMR 




BEQ 


SYSVB7 


JTIMRlr 


JMP 


(CDTMAl) 


JTIMR2: 


JMP 


<CDTMA2) 



; MOVE JOYSTICK TRIGGERS 
; MOVE POT VALUES 



; START POTS FOR NEXT TIME 



i TRANSFER BITS FROM JOYSTICKS 
;T0 PADDLE TRIGGERS 



; GO TO DEFERRED VBLANK ROUTINE 



) ZERO TIMER 
; UNCOND 



SUBROUTINE TO DECREMENT A COUNTDOWN TIMER 

ENTRY X=OFFSET FROM TIMER 1 

EXIT A,P=ZERO IF WENT ZERO, FF OTHERWISE 



DCTIMR: 


LDY 


CDTMVl, X 




LO BYTE 




BNE 


DCTIMl 




NONZERO, GO DEC IT 




LDY 


CDTMVl+1, 


X 


SEE IF BOTH ZERO 




BEQ 


DCTXF 




YES, EXIT NONZERO 




DEC 


CDTMVl+1, 


X 


DEC HI BYTE 


DCTIMl: 


DEC 
BNE 


CDTMVl, X 
DCTXF 




DEC LO BYTE 




LDY 


CDTMVl+1, 


X 






BNE 


DCTXF 








LDA 


#0 




WENT ZERO, RETURN 




RTS 








DCTXF: 


LDA 
RTS 


#*FF 




RETURN NONZERO 



ERR LINE 


ADDR 


Bl 


B2 


B3 


1548 










1549 










1550 










1551 










1552 










1553 










1554 










1555 










1556 


E8ED 


OA 






1557 


ESEE 


8D 


2D 


02 


1558 


E8F1 


8A 






1559 


E8F2 


A2 


05 




1560 


E8F4 


8D 


OA 


D4 


1561 


E8F7 


CA 






1562 


E8F8 


DO 


FD 




1563 


E8FA 


AE 


2D 


02 


1564 


E8FD 


9D 


17 


02 


1565 


E900 


98 






1566 


E901 


9D 


16 


02 


1567 


E904 


60 






1568 










1569 










1570 










1571 


E905 


68 






1572 


E906 


AS 






1573 


E907 


68 






1574 


E908 


AA 






1575 


E909 


68 






1576 


E90A 


40 






1577 


00E6 








1578 


00F3 








1579 


00E7 








1580 


0091 








1581 










1582 


E90B 








1583 










1584 


0014 


39 







INTERRUPT HANDLER 

. PAGE 

SUBROUTINE TO SET VERTICAL BLANK VECTORS AND TIMERS 
ENTRY X=HI,Y=LO BYTE TO SET 
A= 1-5 TIMERS 1-5 

6 I MM VBLANK 

7 DEF VBLANK 



PAGE 
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SETVBL: 


ASL 
STA 
TXA 
LDX 


A 
INTEMP 

#5 




; MUL BY 2 




STA 


WSYNC 




i WASTE 20 CPU CYCLES 


SETLOP : 


DEX 






i TO ALOWD VBLANK TO HAPPE 




BNE 


SETLOP 




; IF THIS IS LINE "7C" 




LDX 


INTEMP 








STA 


CDTMVl- 


-1, X 






TYA 










STA 


CDTMVl- 


-2. X 






RTS 








i EXIT 


FROM VERTICAL BLANK 




XITVBL: 


PLA 
TAY 
PLA 
TAX 
PLA 
RTI 






; UNSTACK Y 

iUNSTACK X 

; UNSTACK A 

; AND GO BACK FROM WHENCE. 


PIRQH 


= 


P IRQ/256 




PIRQL 


= 


(-256)*PIRQH+PIRQ 


PNMIH 


= 


PNM 1/256 




PNMIL 


= 


(-256)*PNMIH+PNMI 


; SPARE 


BYTE OR 


MODULE 


TOO 


LONG FLAG 


CRNTP2 


*=*14 








INTSPR: 


. BYTE 


SIOORG- 


-CRNTP2 i ''•OINTHV IS TOO LONG 



ERR LINE ADDR 81 B2 B3 B4 
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1585 
1586 
1587 
1588 
1589 
1590 
1591 
1592 
1593 
1594 
1595 
1596 
1597 
1598 
1599 
1600 
1601 
1602 
1603 



. TITLE 'SIO ( SERIAL BUS INPUT /OUTPUT CONTROLLER ) ' 
COLLEEN OPERATING SYSTEM 

SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) 
WITH SOFTWARE BAUD RATE CORRECTION ON CASSETTE 



AL MILLER 



3-APR-79 



THIS MODULE HAS ONE ENTRY POINT. IT IS CALLED BY THE DEVICE 
HANDLERS. IT INTERPRETS A PREVIOUSLY ESTABLISHED DEVICE CONTROL 
BLOCK (STORED IN GLOBAL RAM) TO ISSUE COMMANDS 
TO THE SERIAL BUS TO CONTROL TRANSMITTING AND RECEIVING DATA. 



ERR LINE 


ADDR 


1604 




1605 




1606 




1607 




1608 


0030 


1609 




1610 




1611 


0060 


1612 




1613 




1614 




1615 




1616 


0052 


1617 


0057 


1618 




1619 




1620 




1621 




1622 




1623 




1624 


0053 


1625 


004E 


1626 


0044 


1627 


0050 


1628 




1629 




1630 




1631 




1632 


0041 


1633 


004E 


1634 


0043 


1635 


0045 


1636 




1637 




1638 




1639 




1640 


0028 


1641 


0000 


1642 


OOCC 


1643 


0005 


1644 


0005 


1645 


0007 


1646 




1647 




1648 




1649 




1650 




1651 




1652 




1653 




1654 


00B4 


1655 


0078 


1656 


OOOF 


1657 


OOOA 



ADDR Bl B2 B3 B4 



SIO < SERIAL BUS INPUT/OUTPUT CONTROLLER ) 

.PAGE 
EQUATES 



DCD DEVICE BUS ID NUMBERS 
FLOPPY = *30 

iPRINTR = $40 

iCASSET = *60 

CASET = *60 
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BUS COMMANDS 



READ 


'R 


WRITE 


'W 


iSTATIS = 'S 




i FORMAT = '! 





COMMAND AUX BYTES 



SIDWAY 


s 


'S 


NORMAL 


== 


'N 


DOUBLE 


= 


'D 


PLOT 


r= 


'P 



BUS RESPONSES 



ACK 


= 


'A 


NACK 


= 


'N 


COMPLT 


=s 


'C 


ERROR 


= 


'E 



MISCELLANEOUS EQUATES 






B192L0 


= 


*28 ; 


B192HI 


= 


*00 ; 


B600L0 


s 


*CC ; 


B600HI 


= 


*05 i 


HI TONE 


■Si 


$05 i 


LOTONE 


= 


*07 i 


f 


. IF 


PALFLO 


WIROLO 


= 


150 ; 


RIRGLO 


= 


100 i 


WSIRG 


= 


13 i 


RSIRG 


. ENDIF 


8 




. IF 


PALFLG-1 


WIROLO 


= 


180 


RIRGLO 


= 


120 


WSIRG 


= 


15 


RSIRG 


= 


10 



PRINT 16 CHARACTERS SIDEWAYS 
PRINT 40 CHARACTERS NORMALLY 
PRINT 20 CHARACTERS DOUBLE WIDE 
PLOT MODE 



DEVICE ACKNOWLEDGES INFORMATION 

DEVICE DID NOT UNDERSTAND 

DEVICE SUCCESSFULLY COMPLETED OPERATION 

DEVICE INCURRED AN ERROR IN AN ATTEMPTED OP 



19200 BAUD RATE POKEY COUNTER VALUES (LO BY 

(HI BYTE) 

600 BAUD (LO BYTE) 

(HI BYTE) 

FSK HI FREQ POKEY COUNTE VALUE (5326 HZ) 

FSK LO FREQ POKEY COUNTER VALUE (3995 HZ) 



WRITE INTER RECORD GAP (IN 1/60 SEC) 
READ INTER RECORD GAP (IN 1/60 SEC) 
SHORT WRITE INTER RECORD GAP 
SHORT READ INTER RECORD GAP 



WRITE INTER RECORD GAP (IN 1/60 SEC) 
READ INTER RECORD GAP (IN 1/60 SEC) 
SHORT WRITE INTER RECORD GAP 
SHORT READ INTER RECORD GAP 



ERR LINE ADDR Bl B2 B3 B4 



SIO { SERIAL BUS INPUT/OUTPUT CONTROLLER ) 



PAGE 40 



1658 




1659 


0000 


1660 


0000 


1661 




1662 


0034 


1663 


003C 


1664 


0034 


1665 


003C 


1666 




1667 


0002 


1668 


003E 


1669 


0002 


1670 


003A 


1671 




1672 


OOOD 


1673 


0001 


1674 


0002 


1675 


0000 


1676 




1677 




1678 




1679 




1680 





END IF 



WIRGHI 
RIROHI 

NCOMLO 
NCOMHI 
MOTRGO 
MOTRST 

TEMPHI 
TEMPLO 
CBUFHI 
CBUFLO 

CRETRI 
DRETRI 
CTIMLO 
CTIMHI 



JTADRH = 
JTADRL = 






*34 
*3C 
*34 
*3C 



PI A COMMAND TO LOWER NOT COMMAND LINE 
PIA COMMAND TO RAISE NOT COMMAND LINE 
PIA COMMAND TO TURN ON CASSETTE MOTOR 
PIA COMMAND TO TURN OFF MOTOR 



TEMP/256 .ADDRESS OF TEMP CELL (HI BYTE) 
(-256)*TEMPHI+TEMP ; (LO BYTE) 

CDEVIC/256 ; ADDRESS OF COMMAND BUFFER (HI BYTE) 
(-256)*CBUFHI+CDEVIC i (LO BYTE) 



13 
1 
2 




NUMBER OF COMMAND FRAME RETRIES 
NUMBER OF DEVICE RETRIES 
COMMAND FRAME ACK TIME OUT (LO BYTE) 
COMMAND FRAME ACK TIME OUT (HI BYTE) 



JTIMER/256 ; HI BYTE OF JUMP TIMER ROUTINE ADDR 
(-256)*JTADRH+JTIMER ; "MOVED TO LINE 1428" 



ERR LINE ADDR Bl B2 B3 B4 
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1681 










1682 










1683 










1684 










1685 










1686 


E459 


4C 


59 


E9 


1687 










1688 










1689 


E465 


4C 


44 


E9 


1690 










1691 










1692 


E468 


4C 


F2 


EB 


1693 










1694 










1695 










1696 


E48A 


OF 


EB 




1697 


E4SC 


90 


EA 




1698 


E48E 


CF 


EA 




1699 










1700 










1701 










1702 










1703 










1704 










1705 










1706 


E944 


A9 


3C 




1707 


E946 


8D 


02 


D3 


1708 










1709 


E949 


A9 


3C 




1710 


E94B 


8D 


03 


D3 


1711 










1712 










1713 


E94E 


A9 


03 




1714 


E950 


8D 


32 


02 


1715 


E953 


85 


41 




1716 


E955 


8D 


OF 


D2 


1717 










1718 










1719 


E958 


60 






1720 










1721 










1722 










1723 










1724 










1725 










1726 


E959 


BA 






1727 


E95A 


8E 


18 


03 


1728 


E95D 


A9 


01 




1729 


E95F 


85 


42 




1730 










1731 


E961 


AD 


00 


03 


1732 


E964 


C9 


60 




1733 


E966 


DO 


03 




1734 


E968 


4C 


80 


EB 



. PAGE 
SIO 



*=SIOV 

JMP SIO 

*=SIOINV 

JMP SIOINT 

*=SENDEV 

JMP SENDEN 



iSIO ENTRY POINT 

;SIO INITIALIZATION ENTRY POINT 



iSEND ENABLE ENTRY POINT 
*=VC TABL- 1 NTABS+ VSER I N 



. WORD ISRSIR 
. WORD ISRODN 
. WORD ISRTD 



VSER IN 
VSEROR 
VSEROC 



*=SIOORG 
\ SIO INITIALIZATION SUBROUTINE 



SIOINT: LDA 


#MOTRST 


STA 


PACTL 


LDA 


#NCOMHI 


STA 


PBCTL 


LDA 


#3 


STA 


SSKCTL 


STA 


SOUNDR 


STA 


SKCTL 



; TURN OFF MOTOR 

; RAISE NOT COMMAND LINE 



;GET POKEY OUT OF INITIALIZE MODE 
; INIT POKE ADDRESS FOR QUIET I/O 



RTS 



; RETURN 



SIO: 



TSX 




STX 


STACKP 


LDA 


#1 


STA 


CRITIC 


LDA 


DDEVIC 


CMP 


#CASET 


BNE 


NOTCST 


JMP 


CASENT 



;SAVE STACK POINTER 



i BRANCH IF NOT CASSETTE 

i OTHERWISE JUMP TO CASSETTE ENTER 



ERR LINE ADDR Bl B2 B3 B4 



SIO < SERIAL BUS INPUT/OUTPUT CONTROLLER ) 



PAGE 42 



1735 










1736 










1737 










1738 


E96B 


A9 


00 




1739 


E96D 


8D 


OF 


03 


1740 










1741 


E970 


A9 


01 




1742 


E972 


85 


37 




1743 


E974 


A9 


OD 




1744 


E976 


85 


36 




1745 










1746 










1747 










1748 


E978 


A9 


28 




1749 


E97A 


8D 


04 


D2 


1750 


E97D 


A9 


00 




1751 


E97F 


8D 


06 


D2 


1752 










1753 


E982 


18 






1754 


E983 


AD 


00 


03 


1755 


E986 


6D 


01 


03 


1756 


E989 


69 


FF 




1757 


E98B 


8D 


3A 


02 


1758 










1759 


E98E 


AD 


02 


03 


1760 


E991 


8D 


3B 


02 


1761 










1762 


E994 


AD 


OA 


03 


1763 


E997 


8D 


3C 


02 


1764 


E99A 


AD 


OB 


03 


1765 


E99D 


8D 


3D 


02 


1766 










1767 


E9A0 


18 






1768 


E9A1 


A9 


3A 




1769 


E9A3 


85 


32 




1770 


E9A5 


69 


04 




1771 


E9A7 


85 


34 




1772 


E9A9 


A9 


02 




1773 


E9AB 


85 


33 




1774 


E9AD 


85 


35 




1775 










1776 


E9AF 


A9 


34 




1777 


E9B1 


8D 


03 


D3 


1778 










1779 


E9B4 


20 


8A 


EC 


1780 










1781 


E9B7 


AD 


3F 


02 


1782 


E9BA 


DO 


03 




1783 










1784 


E9BC 


98 






1785 


E9BD 


DO 


07 




1786 










1787 










1788 


E9BF 


C6 


36 





; ALL DEVICES 


EXCEPT CA 


NOTCST: 


LDA 


#0 




STA 


CASFLG 


i 


LDA 


#DRETRI 




STA 


DRETRY 


COMMND: 


LDA 


ttCRETRI 




STA 


CRETRY 


; SEND 


A COMMAND FRAME 


COMFRM: 


LDA 


#B192L0 




STA 


AUDF3 




LDA 


#B192HI 




STA 


AUDF4 


/ 


CLC 






LDA 


DDEVIC 




ADC 


DUN IT 




ADC 


#*FF 




STA 


CDEVIC 


i 


LDA 


DCOMND 




STA 


CCOMND 




LDA 


DAUXl 




STA 


CAUXl 




LDA 


DAUX2 




STA 


CAUX2 


' 


CLC 






LDA 


#CBUFLO 




STA 


BUFRLO 




ADC 


#4 




STA 


BFENLO 




LDA 


#CBUFHI 




STA 


BUFRHI 




STA 


BFENHI 


/ 


LDA 


#NCOMLO 




STA 


PBCTL 


J 


JSR 


SEND IN 


* 


LDA 


ERRFLG 




BNE 


BADCOM 


/ 


TYA 






BNE 


ACKREC 


BADCOM: 


DEC 


CRETRY 



; INIT CASSETTE FLAG TO NO CASSETTE 

;SET NUMBER OF DEVICE RETRIES 

iSET NUMBER OF COMMAND FRAME RETRIES 

; SET BAUD RATE TO 19200 

i SET UP COMMAND BUFFER 



SUBTRACT 1 

SET BUS ID NUMBER 



; SET BUS COMMAND 

; STORE COMMAND FRAME AUX BYTES 1 AND 2 

; DONE SETTING UP COMMAND BUFFER 

; SET BUFFER POINTER TO COMMAND FRAME BUFFER 

; AND BUFFER END ADDRESS 

; DONE SETTING UP BUFFER POINTER 
; LOWER NOT COMMAND LINE 

i SEND THE COMMAND FRAME TO A SMART DEVICE 

; BRANCH IF AN ERROR RECEIVED 

(BRANCH IF ACK RECEIVED 

;A NACK OR TIME OUT OCCURED 



ERR LINE ADDR Bl B2 B3 B4 



1789 


E9C1 


10 


B5 




1790 










1791 


E9C3 


4C 


06 


EA 


1792 










1793 










1794 


E9C6 


AD 


03 


03 


1795 


E9C9 


10 


OC 




1796 










1797 










1798 










1799 










1800 










1801 










1802 


E9CB 


A9 


OD 




1803 


E9CD 


85 


36 




1804 










1805 


E9CF 


20 


6A 


EB 


1806 










1807 


E9D2 


20 


8A 


EC 


1808 










1809 


E9D5 


FO 


E8 




1810 










1811 










1812 










1813 










1814 










1815 


E9D7 


20 


75 


EC 


1816 










1817 


E9DA 


A9 


00 




1818 


E9DC 


8D 


3F 


02 


1819 










1820 


E9DF 


20 


9B 


EC 


1821 


E9E2 


FO 


12 




1822 










1823 










1824 










1825 










1826 


E9E4 


2C 


03 


03 


1827 


E9E7 


70 


07 




1828 










1829 


E9E9 


AD 


3F 


02 


1830 


E9EC 


DO 


18 




1831 


E9EE 


FO 


ID 




1832 










1833 










1834 










1835 










1836 










1837 










1838 


E9F0 


20 


6A 


EB 


1839 










1840 


E9F3 


20 


EO 


EA 


1841 










1842 


E9F6 


AD 


3F 


02 
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BPL COMFRM i SO BRANCH IF ANY RETRIES LEFT 
JMP DERRl i OTHERWISE, JUMP TO RETURN SECTION 



ACKREC: LDA DSTATS i ACK WAS RECEIVED 

BPL WATCOM ; BRANCH TO WAIT FOR COMPLETE , 
IF THERE IS NO DATA TO BE SENT 



SEND A DATA FRAME TO PERIPHERAL 



;SET NUMBER OF RETRIES 

;LOAD BUFFER POINTER WITH DCB INFORMATION 
i GO SEND THE DATA FRAME TO A SMART DEVICE 
i BRANCH IF BAD 



WAIT FOR COMPLETE SIGNAL FROM PERIPHERAL 
WATCOM: JSR STTMOT ; SET DDEVICE TIME OUT VALUES IN Y, X 



LDA 


#CRETRI 


STA 


CRETRY 


JSR 


LDPNTR 


JSR 


SEND IN 


BEQ 


BADCOM 



LDA 
STA 

JSR 
BEQ 



#*00 
ERRFLG 

WAITER 
DERR 



DEVICE DID NOT TIME OUT 



BIT 
BVS 

LDA 
BNE 
BEQ 



DSTATS 
MODATA 

ERRFLG 

DERRl 

RETURN 



; CLEAR ERROR FLAG 

iSET UP TIMER AND WAIT 
; BRANCH IF TIME OUT 



BRANCH IF MORE DATA FOLLOWS 



BRANCH IF AN ERROR OCCURRED 
OTHERWISE RETURN 



RECEIVE A DATA FRAME FROM PERIPHERAL 
MODATA: JSR LDPNTR ; LOAD BUFFER POINTER WITH DCB INFORMATION 
JSR RECEIV ; GO RECEIVE A DATA FRAME 

i 

DERR: LDA ERRFLG 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


1843 


E9F9 


FO 


05 




1844 










1845 


E9FB 


AD 


19 


03 


1846 


E9FE 


85 


30 




1847 










1848 










1849 


EAOO 


A5 


30 




1850 


EA02 


C9 


01 




1851 


EA04 


FO 


07 




1852 










1853 


EA06 


C6 


37 




1854 


EA08 


30 


03 




1855 










1856 


EAOA 


4C 


74 


E9 


1857 










1858 










1859 










1860 










1861 


EAOD 


20 


5F 


EC 


1862 


EAIO 


A9 


00 




1863 


EA12 


85 


42 




1864 


EA14 


A4 


30 




1865 


EA16 


8C 


03 


03 


1866 


EA19 


60 






1867 










1868 










1869 










1870 










1871 










1872 










1873 










1874 










1875 










1876 


EAIA 


A9 


00 




1877 


EAIC 


8D 


3F 


02 


1878 










1879 


EAIF 


18 






1880 


EA20 


A9 


3E 




1881 


EA22 


85 


32 




1882 


EA24 


69 


01 




1883 


EA26 


85 


34 




1884 


EA28 


A9 


02 




1885 


EA2A 


85 


33 




1886 


EA2C 


85 


35 




1887 










1888 


EA2E 


A9 


FF 




1889 


EA30 


85 


3C 




1890 










1891 


EA32 


20 


EO 


EA 


1892 










1893 


EA35 


AO 


FF 




1894 


EA37 


A5 


30 




1895 


EA39 


C9 


01 




1896 


EA3B 


DO 


19 
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BEQ NOTERR i BRANCH IF NO ERROR PRECEEDED DATA 



i GET TEMP STATUS 

; STORE IN REAL STATUS 



44 





LDA 


TSTAT 


i 


STA 


STATUS 


i 

NOTERR: 


LDA 


STATUS 




CMP 


#SUCCES 




BEQ 


RETURN 


DERRl: 


DEC 


DRETRY 




BMI 


RETURN 




JMP 


COMMND 



RETURN: 


JSR 


SENDDS 




LDA 


#0 




STA 


CRITIC 




LDY 


STATUS 




STY 


DSTATS 




RTS 


RETURN 



; BRANCH IF COMPLETELY SUCCESSFUL 

i BRANCH IF OUT OF DEVICE RETRIES 
.OTHERWISE, ONE MORE TIME 

; DISABLE POKEY INTERRUPTS 



; RETURN STATUS IN Y 

; AND THE DCB STATUS WORD 



WAIT SUBROUTINE 

WAITS FOR COMPLETE OR ACK 

RETURNS Y=*FF IF SUCCESSFUL/ Y=*00 IF NOT 



WAIT: 



LDA 


#*00 


STA 


ERRFLG 


CLC 




LDA 


#TEMPLO 


STA 


BUFRLO 


ADC 


#1 


STA 


BFENLO 


LDA 


#TEMPHI 


STA 


BUFRHI 


STA 


BFENHI 


LDA 


#*FF 


STA 


NOCKSM 


JSR 


RECEIV 


LDY 


#*FF 


LDA 


STATUS 


CMP 


#SUCCES 


BNE 


NWOK 



; CLEAR ERROR FLAG 

iLOAD BUFFER POINTER WITH ADDRESS 
i OF TEMPORARY RAM CELL 



ALSO SET BUFFER END +1 ADDRESS 

DONE LOADING POINTER 

SET NO CHECKSUM FOLLOWS DATA FLAG 
GO RECEIVE A BYTE 
ASSUME SUCCESS 

BRANCH IF IT DID NOT WORK OK 



ERR LINE 


ADDR 


Bl 


B2 B3 


1897 








1898 








1899 








1900 








1901 


EA3D 


AD 


3E 02 


1902 


EA40 


C9 


41 


1903 


EA42 


FO 


21 


1904 


EA44 


C9 


43 


1905 


EA46 


FO 


ID 


1906 








1907 


EA48 


C9 


45 


1908 


EA4A 


DO 


06 


1909 








1910 


EA4C 


A9 


90 


1911 


EA4E 


85 


30 


1912 


EA50 


DO 


04 


1913 








1914 


EA52 


A9 


8B 


1915 


EA54 


85 


30 


1916 








1917 


EA56 


A5 


30 


1918 


EA58 


C9 


8A 


1919 


EA5A 


FO 


07 


1920 








1921 


EA5C 


A9 


FF 


1922 


EASE 


8D 


3F 02 


1923 


EA61 


DO 


02 


1924 








1925 


EA63 


AO 


00 


1926 








1927 


EA65 


A5 


30 


1928 


EA67 


8D 


19 03 


1929 


EA6A 


60 




1930 








1931 








1932 








1933 








1934 








1935 








1936 








1937 








1938 








1939 








1940 


EA6B 


A9 


01 


1941 


EA6D 


85 


30 


1942 








1943 


EA6F 


20 


F2 EB 


1944 








1945 


EA72 


AO 


00 


1946 


EA74 


84 


31 


1947 


EA76 


84 


3B 


1948 


EA78 


84 


3A 


1949 








1950 
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PAGE 



45 



WOK: 


LDA 


TEMP 




CMP 


#ACK 




BEQ 


GOOD 




CMP 


#COMPLT 




BEQ 


GOOD 


/ 


CMP 


#ERROR 




BNE 


NOTDER 


; A DEVICE ERROR CODE 




LDA 


#DERROR 




STA 


STATUS 




BNE 


NWOK 


» 
NOTDER : 


LDA 


#DNACK 




STA 


STATUS 


NWOK: 


LDA 


STATUS 




CMP 


#TIMOUT 




BEQ 


BAD 


/ 


LDA 


#*FF 




STA 


ERRFLG 




BNE 


GOOD 


BAD: 


LDY 


#0 


GOOD: 


LDA 


STATUS 




STA 


TSTAT 




RTS 





;MAKE SURE THE BYTE SUCCESSFULLY RECEIVED 
i WAS ACTUALLY AN ACK OR COMPLETE 



; BRANCH IF DEVICE DID NOT SEND BACK 



; SET DEVICE ERROR STATUS 



i OTHERWISE SET NACK STATUS 



; BRANCH IF TIME OUT 



; SET SOME ERROR FLAG 

; RETURN WITH OUT SETTING Y = 



1 RETURN 



SEND SUBROUTINE 

SENDS A BUFFER OF BYTES OUT OVER THE SERIAL BUS 



SEND: 



LDA 
STA 

JSR 



#SUCCES 
STATUS 

SENDEN 



; ASSUME SUCCESS 



.ENABLE SENDING 



LDY 


#0 


STY 


CHKSUM 


STY 


CHKSNT 


STY 


XMTDON 



CLEAR CHECK SUM 
CHECKSUM SENT FLAG 
TRANSMISSION DONE FLAG 



ERR LINE 


ADDR 


Bl 


B2 


B3 


1951 


EA7A 


Bl 


32 




1952 


EA7C 


80 


OD 


D2 


1953 










1954 










1955 


EA7F 


85 


31 




1956 










1957 


EA81 


A5 


11 




1958 


EA83 


DO 


03 




1959 


EA85 


4C 


AO 


ED 


1960 










1961 


EA88 


A5 


3A 




1962 


EA8A 


FO 


F5 




1963 










1964 


EA8C 


20 


5F 


EC 


1965 










1966 


EA8F 


60 






1967 










1968 










1969 










1970 










1971 










1972 










1973 










1974 










1975 


EA90 


98 






1976 


EA91 


48 






1977 










1978 


EA92 


E6 


32 




1979 


EA94 


DO 


02 




1980 


EA96 


E6 


33 




1981 










1982 


EA98 


A5 


32 




1983 


EA9A 


C5 


34 




1984 


EA9C 


A5 


33 




1985 


EA9E 


E5 


35 




1986 


EAAO 


90 


IC 




1987 










1988 


EAA2 


A5 


3B 




1989 


EAA4 


DO 


OB 




1990 










1991 


EAA6 


A5 


31 




1992 


EAA8 


8D 


OD 


D2 


1993 


EAAB 


A9 


FF 




1994 


EAAD 


85 


3B 




1995 


EAAF 


DO 


09 




1996 










1997 


EABl 


A5 


10 




1998 


EAB3 


09 


08 




1999 


EAB5 


85 


10 




2000 


EAB7 


8D 


OE 


D2 


2001 










2002 


EABA 


68 






2003 


EABB 


A8 






2004 


EABC 


68 
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LDA 


(BUFRL 


/ 


STA 


SEROUT 


' 


STA 


CHKSUM 


/ 

NOTDON: 


LDA 


BRKKEY 




BNE 


NTBRKO 




JMP 


BROKE 


NTBRKO: 


LDA 


XMTDON 




BEQ 


NOTDON 




JSR 


SENDDS 




RTS 





(BUFRLO),Y ;PUT FIRST BYTE FROM BUFFER 

; INTO THE SERIAL OUTPUT REGISTER 



; PUT IT IN CHECKSUM 

i JUMP IF BREAK KEY PRESSED 
;LOOP UNTIL TRANSMISSION IS DONE 

; DISABLE SENDING 
; RETURN 



OUTPUT DATA NEEDED INTERRUPT SERVICE ROUTINE 

; SAVE Y REG ON STACK 

; INCREMENT BUFFER POINTER 

; CHECK IF PAST END OF BUFFER 

;HIGH PART 

; BRANCH IF NOT PAST END OF BUFFER 

; BRANCH IF CHECKSUM ALREADY SENT 

; SEND CHECK SUM 

; SET CHECKSUM SENT FLAG 

; ENABLE TRANSMIT DONE INTERRUPT 



i RESTORE Y REG 

; RETURN FROM INTERRUPT 



ISRODN: 


TYA 
PHA 




i 


INC 


BUFRLO 




BNE 


NOWRPO 




INC 


BUFRHI 


NOWRPO: 


LDA 


BUFRLO 




CMP 


BFENLO 




LDA 


BUFRHI 




SBC 


BFENHI 




BCC 


NOTEND 


i 


LDA 


CHKSNT 




BNE 


RELONE 


i 


LDA 


CHKSUM 




STA 


SEROUT 




LDA 


#*FF 




STA 


CHKSNT 




BNE 


CHKDON 


RELONE: 


LDA 


POKMSK 




OR A 


#*08 




STA 


POKMSK 




STA 


IRQEN 


CHKDON: 


PLA 
TAY 
PLA 





LINE 


ADDR 


Bl 


B2 


B3 B4 


2005 


EABD 


40 






2006 










2007 










2008 


EABE 


AO 


00 




2009 


EACO 


Bl 


32 




2010 


EAC2 


SD 


OD 


D2 


2011 










2012 


EAC5 


18 






2013 


EAC6 


65 


31 




2014 


EAC8 


69 


00 




2015 


EACA 


85 


31 




2016 










2017 


EACC 


4C 


BA 


EA 


2018 










2019 










2020 










2021 










2022 










2023 










2024 










2025 










2026 


EACF 


A5 


3B 




2027 


EADl 


FO 


OB 




2028 










2029 


EAD3 


85 


3A 




2030 










2031 


EAD5 


A5 


10 




2032 


EAD7 


29 


F7 




2033 


EAD9 


85 


10 




2034 


EADB 


8D 


OE 


D2 


2035 










2036 


EADE 


68 






2037 


EADF 


40 






2038 










2039 










2040 










2041 










2042 










2043 










2044 










2045 










2046 










2047 










2048 


EAEO 


A9 


00 




2049 










2050 


EAE2 


AC 


OF 


03 


2051 


EAE5 


DO 


02 




2052 










2053 


EAE7 


85 


31 




2054 


EAE9 


85 


38 




2055 


EAEB 


85 


39 




2056 










2057 










2058 
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NOTEND: 


LDY 


»0 




LDA 


{ BUFRLO > , Y 




STA 


SEROUT 


' 


CLC 






ADC 


CHKSUM 




ADC 


#0 




STA 


CHKSUM 


' 


JMP 


CHKDON 



iPUT NEXT BYTE FROM BUFFER 

; INTO THE SERIAL OUTPUT REGISTER 

iADD IT TO CHECKSUM 



;G0 RETURN 



TRANSMIT DONE INTERRUPT SERVICE ROUTINE 



ISRTD: 


LDA 


CHKSNT 




BEQ 


FOOEY 




STA 


XMTDON 


i 


LDA 


POKMSK 




AND 


#*F7 




STA 


POKMSK 




STA 


IRQEN 


FOOEY: 


PLA 
RTI 





i BRANCH IF CHECKSUM NOT YET SENT 
.OTHERWISE SET TRANSMISSION DONE FLAG 
; DISABLE TRANSMIT DONE INTERRUPT 

; RETURN FROM INTERRUPT 



RECEIVE SUBROUTINE 



RECEIV: LDA 

LDY 
BNE 



NOCLR : 



STA 
STA 
STA 



#0 

CASFLO 
NOCLR 

CHKSUM 
BUFRFL 
RECVDN 



i BRANCH IF CASSETTE 

; CLEAR CHKSUM 

; BUFFER FULL FLAG 

; RECEIVE DONE FLAG 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


2059 


EAED 


A9 


01 




2060 


EAEF 


85 


30 




2061 


EAFl 


20 


IB 


EC 


2062 


EAF4 


A9 


3C 




2063 


EAF6 


8D 


03 


D3 


2064 


EAF9 


A5 


11 




2065 


EAFB 


DO 


03 




2066 


EAFD 


4C 


AO 


ED 


2067 










2068 


EBOO 


AD 


17 


03 


2069 


EB03 


FO 


05 




2070 


EB05 


A5 


39 




2071 


EB07 


FO 


FO 




2072 


EB09 


60 






2073 


EBOA 


A9 


8A 




2074 


EBOC 


85 


30 




2075 










2076 










2077 










2078 










2079 










2080 










2081 


EBOE 


60 






2082 










2083 










2084 










2085 










2086 










2087 










2088 










2089 










2090 










2091 


EBOF 


98 






2092 


EBIO 


48 






2093 










2094 










2095 










2096 


EBll 


AD 


OF 


D2 


2097 


EB14 


8D 


OA 


D2 


2098 










2099 










2100 


EB17 


30 


04 




2101 










2102 


EB19 


AO 


8C 




2103 


EBIB 


84 


30 




2104 










2105 


EBID 


29 


20 




2106 


EBIF 


DO 


04 




2107 










2108 


EB21 


AO 


8E 




2109 


EB23 


84 


30 




2110 










2111 


EB25 


A5 


38 




2112 


EB27 


FO 


13 
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LDA 


#SUCCES 




STA 


STATUS 




JSR 


RECVEN 




LDA 


#NCOMHI 




STA 


PBCTL 


CHKTIM: 


LDA 


BRKKEY 




BNE 


NTBRKl 




JMP 


BROKE 


NTBRKl: 


LDA 


TIMFLG 




BEQ 


TOUT 




LDA 


RECVDN 




BEQ 


CHKTIM 


GOBACK: 


RTS 




TOUT: 


LDA 


#TIMOUT 




STA 


STATUS 



SET GOOD STATUS FOR DEFAULT CASE. 
DO RECEIVE ENABLE 
COMMAND FRAME HI COMMAND 
STORE IN PIA 



; JUMP IF BREAK KEY PRESSED 

;N0, 

/ IF TIMEOUT, GO SET ERROR STATUS 

i DONE ? 

; YES, 

;SET TIMEOUT STATUS 



RRETRN: RTS 



; RETURN 



SERIAL INPUT READY INTERRUPT SERVICE ROUTINE 



i SAVE Y REG ON STACK 



i RESET STATUS REGISTER 
THIS MAY NOT BE THE PLACE TO DO IT *******#* 



ISRSIR: 


TYA 
PHA 






LDA 


SKSTAT 




STA 


SKRES 


; #*»*»*»* 


THIS MAY N{ 


» 


BMI 


NTFRAM 


/ 


LDY 


#FRMERR 




STY 


STATUS 


NTFRAM: 


AND 


#*20 




BNE 


NTOVRN 


f 


LDY 


#OVRRUN 




STY 


STATUS 


NTOVRN: 


LDA 


BUFRFL 




BEQ 


NOTYET 



i BRANCH IF NO FRAMING ERROR 



; SET FRAME ERRORR STATUS 



; BRANCH IF NO OVERRUN ERROR 



; SET OVERRUN ERROR STATUS 



BRANCH IF BUFFER WAS NOT YET FILLED 



ERR LINE 


ADDR 


Bl 


B2 B3 


B4 


2113 










2114 


EB29 


AD 


OD D2 




2115 


EB2C 


C5 


31 




2116 


EB2E 


FO 


04 




2117 










2118 


EB30 


AO 


8F 




2119 


EB32 


84 


30 




2120 










2121 


EB34 


A9 


FF 




2122 


EB36 


85 


39 




2123 










2124 


EB38 


68 






2125 


EB39 


A8 






2126 


EB3A 


68 






2127 


EB3B 


40 






2128 










2129 










2130 










2131 


EB3C 


AD 


OD D2 




2132 


EB3F 


AO 


00 




2133 


EB41 


91 


32 




2134 










2135 


EB43 


18 






2136 


EB44 


65 


31 




2137 


EB46 


69 


00 




2138 


EB48 


85 


31 




2139 










2140 


EB4A 


E6 


32 




2141 


EB4C 


DO 


02 




2142 


EB4E 


E6 


33 




2143 










2144 


EB50 


A5 


32 




2145 


EB52 


C5 


34 




2146 


EB54 


A5 


33 




2147 


EB56 


E5 


35 




2148 


EB58 


90 


DE 




2149 










2150 


EB5A 


A5 


3C 




2151 


EB5C 


FO 


06 




2152 










2153 


EB5E 


A9 


00 




2154 


EB60 


85 


3C 




2155 










2156 


EB62 


FO 


DO 




2157 










2158 










2159 


EB64 


A9 


FF 




2160 


EB66 


85 


38 




2161 










2162 


EB68 


DO 


CE 




2163 










2164 










2165 










2f66 
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LDA 


SERIN 




CMP 


CHKSUM 




BEQ 


SRETRN 




LDY 


#CHKERR 




STY 


STATUS 


SRETRN: 


LDA 


#*FF 




STA 


RECVDN 


SUSUAL: 


PLA 
TAY 
PLA 
RTI 




NOTYET: 


LDA 


SERIN 




LDY 


#0 




STA 


(BUFRLOJ/ Y 




CLC 






ADC 


CHKSUM 




ADC 


#0 




STA 


CHKSUM 


i 


INC 


BUFRLO 




BNE 


NTWRPl 




INC 


BUFRHI 


NTWRPl: 


LDA 


BUFRLO 




CMP 


BFENLO 




LDA 


BUFRHI 




SBC 


BFENHI 




BCC 


SUSUAL 


' 


LDA 


NQCKSM 




BEQ 


GOON 


/ 


LDA 


#0 




STA 


NOCKSM 


i 


BEQ 


SRETRN 


GOON: 


LDA 


#*FF 




STA 


BUFRFL 


' 


BNE 


SUSUAL 



; THIS INPUT BYTE IS THE CHECKSUM 
! BRANCH IF CHECKSUMS MATCH 

; SET CHECKSUM ERROR STATUS 
; SET RECEIVE DONE FLAG 



; RESTORE Y REG 

; RETURN FROM INTERRUPT 



; STORE INPUT REGISTER INTO BUFFER 
; ADD IT TO CHECKSUM 

; INCREMENT BUFFER POINTER 



; BRANCH IF NEW BUFFER ADDRESS IS IN BUFFER L 

; BRANCH IF A CHECKSUM WILL FOLLOW DATA 

; CLEAR NO CHECKSUM FLAG 

,G0 RETURN AND SET RECEIVE DONE FLAG 

i SET BUFFER FULL FLAG 
; GO RETURN 



ERR LINE 


ADDR 


Bl 


B2 


B3 


2167 










2168 










2169 










2170 










2171 










2172 










2173 










2174 










2175 


EB6A 


18 






2176 


EB6B 


AD 


04 


03 


2177 


EB6E 


85 


32 




2178 


EB70 


6D 


08 


03 


2179 


EB73 


85 


34 




2180 










2181 


EB75 


AD 


05 


03 


2182 


EB78 


85 


33 




2183 


EB7A 


6D 


09 


03 


2184 


EB7D 


85 


35 




2185 










2186 


EB7F 


60 






2187 










2188 










2189 










2190 










2191 










2192 










2193 










2194 










2195 










2196 










2197 


EB80 


AD 


03 


03 


2198 


EB83 


10 


2E 




2199 










2200 










2201 










2202 


EB85 


A9 


CC 




2203 


EB87 


8D 


04 


D2 


2204 


EB8A 


A9 


05 




2205 


EB8C 


8D 


06 


D2 


2206 










2207 


EB8F 


20 


F2 


EB 


2208 










2209 


EB92 


AO 


OF 




2210 


EB94 


AD 


OB 


03 


2211 


EB97 


30 


02 




2212 










2213 


EB99 


AO 


B4 




2214 


EB9B 


A2 


00 




2215 


EB9D 


20 


B9 


ED 


2216 










2217 


EBAO 


A9 


34 




2218 


EBA2 


8D 


02 


D3 


2219 










2220 


EBA5 


AD 


17 


03 
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LOAD BUFFER POINTER SUBROUTINE 

LOAD BUFFER POINTER WITH DCB BUFFER INFORMATION 



LDPNTR: CLC 




LDA 


DBUFLO 


STA 


BUFRLO 


ADC 


DBYTLO 


STA 


BFENLO 


LDA 


DBUFHI 


STA 


BUFRHI 


ADC 


DBYTHI 


STA 


BFENHI 



RTS 



CASSETTE HANDLING CODE 

CASENT: LDA DSTATS 
BPL CASRED 

WRITE A RECORD 





LDA 


#B600L0 




STA 


AUDF3 




LDA 


#B600HI 




STA 


AUDF4 




JSR 


SENDEN 


i 


LDY 


#WSIRO 




LDA 


DAUX2 




BMI 


SRTIRO 




LDY 


#WIRGLO 


SRTIRO: 


LDX 


#WIRGHI 




JSR 


SETVBX 




LDA 


#MOTRGO 




STA 


PACTL 


TIMIT: 


LDA 


TIMFLG 



; ALSO SET BUFFER END + 1 ADDRESS 



; RETURN 



i BRANCH IF INPUT FROM CASSETTE 
; SET BAUD RATE TO 600 

; TURN ON POKEY MARK TONE 

; LOAD SHORT WRITE INTER RECORD GAP TIME 

; BRANCH IF SHORT GAP IS DESIRED 

;SET WRITE IRG TIME 

; TURN ON MOTOR 
; LOOP UNTIL DONE 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


2221 


EBA8 


DO 


FB 




2222 










2223 


EBAA 


20 


6A 


EB 


2224 










2225 


EBAD 


20 


6B 


EA 


2226 










2227 


EBBO 


4C 


DF 


EB 


2228 










2229 










2230 










2231 










2232 










2233 


EBB3 


A9 


FF 




2234 


EBB5 


8D 


OF 


03 


2235 










2236 


EBBS 


AO 


OA 




2237 


EBBA 


AD 


OB 


03 


2238 


EBBD 


30 


02 




2239 










2240 


EBBF 


AO 


78 




2241 


EBCl 


A2 


00 




2242 


EBC3 


20 


B9 


ED 


2243 










2244 


EBC6 


A9 


34 




2245 


EBC8 


8D 


02 


D3 


2246 










2247 


EBCB 


AD 


17 


03 


2248 


EBCE 


DO 


FB 




2249 










2250 


EBDO 


20 


6A 


EB 


2251 










2252 


EBD3 


20 


75 


EC 


2253 


EBD6 


20 


B9 


ED 


2254 










2255 


EBD9 


20 


10 


ED 


2256 










2257 


EBDC 


20 


EO 


EA 


2258 










2259 


EBDF 


AD 


OB 


03 


2260 


EBE2 


30 


05 




2261 










2262 


EBE4 


A9 


3C 




2263 


EBE6 


8D 


02 


D3 


2264 










2265 


EBE9 


4C 


OD 


EA 


2266 










2267 










2268 










2269 










2270 










2271 


EBEC 


A9 


00 




2272 


OOEB 








2273 


OOEC 








2274 


EBEE 


8D 


17 


03 
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BNE TIMIT 

JSR LDPNTR iLOAD BUFFER POINTER WITH DCB INFORMATION 
JSR SEND iSEND A BUFFER 
JMP CRETRN ;00 RETURN 

RECEIVE A RECORD 

■F 

;SET SET CASSETTE FLAG 

iLOAD SHORT READ INTER RECORD GAP TIME 

i BRANCH IF SHORT GAP IS DESIRED 

;SET TIME OUT FOR READ IRG 

; TURN ON MOTOR 
;LOOP UNTIL DONE 

iLOAD BUFFER POINTER WITH DCB INFORMATION 
iSET DEVICE TIME OUT IN Y, X 

iSET INITIAL BAUD RATE 
; GO RECEIVE A BLOCK 



CASRED: 


LDA 


#*FF 




STA 


CASFLG 


' 


LDY 


#RSIRG 




LDA 


DAUX2 




BMI 


SRTIRl 


i 


LDY 


#RIRGLO 


SRTIRl: 


LDX 


#RIRGHI 




JSR 


SETVBX 


' 


LDA 


#MOTRGO 




STA 


PACTL 


TIMITl: 


LDA 


TIMFLO 




BNE 


TIMITl 




JSR 


LDPNTR 


' 


JSR 


STTMOT 




JSR 


SETVBX 


i 


JSR 


BEGIN 




JSR 


RECEIV 


CRETRN: 


LDA 


DAUX2 




BMI 


SRTIR2 



DON'T TURN OFF CASSETTE 
LDA #MOTRST 
STA PACTL 



SRTIR2: JMP 



JTIMER: LDA 
JTADRH = 
JTADRL = 

STA 



RETURN 



i BRANCH IF DOING SHORT INTER RECORD GAPS 
MOTOR 

i TURN OFF MOTOR 

i GO RETURN 



#*00 

JTIMER/256 i HI BYTE OF JUMP TIMER ROUTINE ADDR 

( -256 > * JTADRH+ JT IMER 

TIMFLG i SET TIME OUT FLAG 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


2275 


EBFl 


60 






2276 










2277 










2278 










2279 










2280 










2281 










2282 










2283 










2284 


EBF2 


A9 


07 




2285 


EBF4 


2D 


32 


02 


2286 


EBF7 


09 


20 




2287 










2288 


EBF9 


AC 


00 


03 


2289 


EBFC 


CO 


60 




2290 


EBFE 


DO 


OC 




2291 










2292 


EC 00 


09 


08 




2293 










2294 


EC 02 


AO 


07 




2295 


EC04 


8C 


02 


D2 


2296 


EC 07 


AO 


05 




2297 


EC 09 


8C 


00 


D2 


2298 










2299 


ECOC 


8D 


32 


02 


2300 


EC OF 


8D 


OF 


D2 


2301 










2302 


EC 12 


A9 


C7 




2303 


EC 14 


25 


10 




2304 


EC 16 


09 


10 




2305 










2306 










2307 


EC18 


4C 


31 


EC 


2308 










2309 










2310 










2311 










2312 










2313 










2314 










2315 










2316 










2317 










2318 










2319 










2320 


EC IB 


A9 


07 




2321 


ECID 


2D 


32 


02 


2322 


EC 20 


09 


10 




2323 


EC 22 


8D 


32 


02 


2324 


EC25 


8D 


OF 


D2 


2325 










2326 


EC28 


8D 


OA 


02 


2327 










2328 


EC2B 


A9 


C7 
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SEND ENABLE SUBROUTINE 



SENDEN: 


LDA 


#*07 




AND 


SSKCTL 




OR A 


#*20 


i 


LDY 


DDEVIC 




CPY 


#CASET 




BNE 


NOTCAS 



ORA 



#*08 



LDY 


#LOTONE 


STY 


AUDF2 


LDY 


#HITONE 


STY 


AUDFl 


i 

NOTCAS: STA 


SSKCTL 


STA 


SKCTL 


LDA 


#*C7 


AND 


POKMSK 


ORA 

i 


#*10 


JMP 


CONTIN 



/MASK OFF PREVIOUS SERIAL BUS CONTROL BITS 
; SET TRANSMIT MODE 

; BRANCH IF NOT CASSETTE 
;SET THE FSK OUTPUT BIT 
iSET FSK TONE FREQUENCIES 



; STORE NEW VALUE TO SYSTEM MASK 
i STORE TO ACTUAL REGISTER 

;MASK OFF PREVIOUS SERIAL BUS INTERRUPT BITS 

; ENABLE OUTPUT DATA NEEDED INTERRUPT 

; GO CONTINUE IN RECEIVE ENABLE SUBROUTINE 



RECEIVE ENABLE SUBROUTINE 



RECVEN: 


LDA 


#*07 




AND 


SSKCTL 




ORA 


#*10 




STA 


SSKCTL 




STA 


SKCTL 




STA 


SKRES 




LDA 


»*C7 



, MASK OFF PREVIOUS SERIAL BUS CONTROL BITS 

;SET RECEIVE MODE ASYNCH. 

; STORE NEW VALUE TO SYSTEM MASK 

i STORE TO ACTUAL REGISTER 

; RESET SERIAL PORT/KEYBOARD STATUS REGISTER 

;MASK OFF PREVIOUS SERIAL BUS INTERRUPT BITS 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


2329 


EC2D 


25 


10 




2330 


EC2F 


09 


20 




2331 


EC31 


85 


10 




2332 


EC33 


8D 


OE 


D2 


2333 










2334 










2335 


EC 36 


A9 


28 




2336 


EC 38 


8D 


08 


D2 


2337 










2338 


EC3B 


A2 


06 




2339 


EC 3D 


A9 


Ae 




2340 


EC3F 


A4 


41 




2341 


EC41 


DO 


02 




2342 


EC 43 


A9 


AO 




2343 


EC45 


9D 


01 


D2 


2344 


EC 48 


CA 






2345 


EC 49 


CA 






2346 


EC4A 


10 


F9 




2347 










2348 


EC4C 


A9 


AO 




2349 


EC4E 


8D 


05 


D2 


2350 


EC51 


AC 


00 


03 


2351 


EC 54 


CO 


60 




2352 


EC 56 


FO 


06 




2353 


EC 58 


8D 


01 


D2 


2354 


EC5B 


8D 


03 


D2 


2355 










2356 










2357 


EC5E 


60 






2358 










2359 










2360 










2361 










2362 










2363 










2364 










2365 










2366 










2367 










2368 










2369 










2370 


EC5F 


EA 






2371 


EC 60 


A9 


C7 




2372 


EC 62 


25 


10 




2373 


EC 64 


85 


10 




2374 


EC 66 


8D 


OE 


D2 


2375 










2376 


EC 69 


A2 


06 




2377 


EC6B 


A9 


00 




2378 


EC6D 


9D 


01 


D2 


2379 


EC 70 


CA 






2380 


EC71 


CA 






2381 


EC 72 


10 


F9 




2382 
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AND 


POKMSK 


OR A 


#*20 


CONTIN: STA 


POKMSK 


STA 
* 


IRQEN 


i 

LDA 


#*28 


STA 


AUDCTL 


» 

LDX 


#6 


LDA 


#*A8 


LDY 


SOUNDR 


BNE 


NOISEl 


LDA 


#$A0 


NOISEl: STA 


AUDC 1 , X 


DEX 




DEX 




BPL 


NOISEl 


LDA 


#*A0 


STA 


AUDC 3 


LDY 


DDEVIC 


CPY 


#CASET 


BEQ 


CAS31 


STA 


AUDCl 


STA 


AUDC 2 



CAS31 



RTS 



ENABLE RECEIVE INTERRUPT 
STORE NEW VALUE TO SYSTEM MASK 
STORE TO ACTUAL REGISTER 



i CLOCK CH. 3 WITH 1.79 MHZ 
i CLOCK CH. 4 WITH CH. 3 

; SET PURE TONES, NO VOLUME 

i TEST QUIET I/O FLAG 
;NE IS NORMAL (NOISY) 



i TURN OFF SOUND ON CHANNEL 3 



; BRANCH IF CASSETTE IS DESIRED 
.OTHERWISE TURN OFF CHANNELS 1 AND 2 



; RETURN 



DISABLE SEND AND DISABLE RECEIVE SUBROUTINES 

;MASK OFF SERIAL BUS INTERRUPTS 

i STORE NEW VALUE TO SYSTEM MASK 
; STORE TO ACTUAL REGISTER 



SENDDS: 


NOP 




RECVDS: 


LDA 


#*C7 




AND 


POKMSK 




STA 


POKMSK 




STA 


IRQEN 


i 


LDX 


#6 




LDA 


#0 


ZERIT: 


STA 
DEX 
DEX 


AUDCl. X 




BPL 


ZERIT 



; TURN OFF AUDIO VOLUME 



ERR LINE ADDR Bl 62 B3 B4 
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2383 


EC 74 


60 




2384 








2385 








2386 








2387 








2388 








2387 








2390 








2391 








2392 








2393 








2394 








2395 








2396 


EC75 


AD 


06 03 


2397 


EC 78 


6A 




2398 


EC 79 


6A 




2399 


EC 7 A 


A8 




2400 


EC7B 


29 


3F 


2401 


EC7D 


AA 




2402 








2403 


EC7E 


98 




2404 


EC7F 


6A 




2405 


EC 80 


29 


CO 


2406 


EC 82 


A8 




2407 








2408 


EC83 


60 




2409 








2410 








2411 








2412 








2413 








2414 








2415 








2416 








2417 








2418 








2419 


EC 84 


OF 


EB 


2420 


EC 86 


90 


EA 


2421 


EC 88 


CF 


EA 


2422 








2423 


OOEB 






2424 


OOOF 






2425 


OOEA 






2426 


0090 






2427 


OOEA 






2428 


OOCF 






2429 








2430 








2431 








2432 








2433 








2434 








2435 








2436 


EC 8 A 


A2 


01 



RTS 



i RETURN 



SET DDEVICE TIME OUT VALUES IN Y, X SUBROUTINE 



STTMOT: 


LDA 


DTIMLO 




ROR 


A 




ROR 


A 




TAY 






AND 


#*3F 




TAX 






TYA 






ROR 


A 




AND 


#*C0 




TAY 





RTS 



INTTBL: . WORD 
. WORD 
. WORD 

SIRHI 

SIRLO 

ODNHI 

ODNLO 

TDHI 

TDLO 



;GET DEVICE TIME OUT IN 1 SECOND INCR 
iPUT 6 HI BITS IN X, LO 2 BITS IN Y 

TEMP SAVE 

MASK OFF 2 HI BITS 

THIS IS HI BYTE OF TIME OUT 

RESTORE 

MASK OFF ALL BUT 2 HI BITS 
THIS IS LQ BYTE OF TIME OUT 



ISRSIR 
ISRODN 
ISRTD 



SERIAL INPUT READY 
OUTPUT DATA NEEDED 
TRANSMISSION DONE 



ISRSIR/256 ; SERIAL INPUT READY ISR ADDRESS 

( -256 >*SIRHI+ ISRSIR 

ISRODN/256 ; OUTPUT DATA NEEDED ISR ADDRESS 

( -256 ) *ODNH I + I SRODN 

ISRTD/256 i TRANSMISSION DONE ISR ADDRESS 

(-256>*TDHI+ISRTD 



SEND A DATA FRAME TO AN INTELLIGENT PERIPHERAL SUBROUTINE 



SENDIN: LDX 



#*01 



ERR LINE 


ADDR 


Bl 


B2 


B3 


2437 


EC8C 


AO 


FF 




2438 


EC8E 


88 






2439 


EC8F 


DO 


FD 




2440 


EC91 


CA 






2441 


EC92 


DO 


F8 




2442 










2443 


EC 94 


20 


6B 


EA 


2444 










2445 


EC 97 


AO 


02 




2446 


EC 99 


A2 


00 




2447 


EC9B 


20 


B9 


ED 


2448 










2449 


EC9E 


20 


lA 


EA 


2450 










2451 


ECAl 


98 






2452 










2453 


ECA2 


60 






2454 










2455 










2456 










2457 










2458 










2459 










2460 










2461 










2462 










2463 










2464 










2465 










2466 










2467 










2468 


EC A3 


8D 


10 


03 


2469 


ECA6 


8C 


11 


03 


2470 


ECA9 


20 


04 


ED 


2471 


ECAC 


8D 


10 


03 


2472 


ECAF 


AD 


OC 


03 


2473 


ECB2 


20 


04 


ED 


2474 


ECB5 


8D 


OC 


03 


2475 


ECB8 


AD 


10 


03 


2476 


ECBB 


38 






2477 


ECBC 


ED 


OC 


03 


2478 


ECBF 


8D 


12 


03 


2479 


ECC2 


AD 


11 


03 


2480 


ECC5 


38 






2481 


ECC6 


ED 


OD 


03 


2482 


ECC9 


A8 






2483 










2484 










2485 










2486 










2487 










2488 










2489 


ECCA 


A9 


7D 




2490 


ECCC 


18 
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DELAYO: LDY 

DELAY 1: DEY 

ONE 

DEX 

BNE 



JSR 





LDY 


#CTIMLO 




LDX 


#CTIMHI 


WAITER: 


JSR 


SETVBX 


i 


JSR 


WAIT 


/ 


TYA 






RTS 





; GO SEND THE DATA FRAME 
i SET ACK TIME OUT 

; WAIT FOR ACK 

; IF Y=0, A TIME OUT OR NACK OCCURED 

; RETURN 



COMPUTE VALUE FOR POKEY FREQ REGS FOR THE BAUD RATE AS 
MEASURED BY AN INTERVAL OF THE 'VCOUNT' TIMER. 



SAVE FINAL TIMER VALUE 
ADJUST VCOUNT VALUE 
SAVE ADJUSTED VALUE 

; ADJUST 

;SAVE ADJUSTED TIMERl VALUE 



COMPUT: 


STA 


TIMER2 




STY 


TIMER2+1 




JSR 


ADJUST 




STA 


TIMER2 




LDA 


TIMERl 




JSR 


ADJUST 




STA 


TIMERl 




LDA 


TIMER2 




SEC 






SBC 


TIMERl 




STA 


TEMPI 




LDA 


TIMER2+1 




SEC 






SBC 


TIMERl-H 




TAY 






. IF 


PALFLO 




LDA 


#-*9C 


HITIMR: 


CLC 






ADC 


#*9C 




. ENDIF 






. IF 


PALFLG-1 




LDA 


#-*83 


HITIMR: 


CLC 





iFIND VCOUNT DIFFERENCE 



iFIND VBLANK COUNT DIFFERENCE 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


2491 


ECCD 


69 


83 




2492 










2493 


ECCF 


88 






2494 


EC DO 


10 


FA 




2495 


ECD2 


18 






2496 


ECD3 


6D 


12 


03 


2497 


ECD6 


A8 






2498 


ECD7 


4A 






2499 


ECD8 


4A 






2500 


ECD9 


4A 






2501 


EC DA 


OA 






2502 


ECDB 


38 






2503 


ECDC 


E9 


16 




2504 


ECDE 


AA 






2505 


ECDF 


98 






2506 


ECEO 


29 


07 




2507 


ECE2 


A8 






2508 


ECE3 


A9 


F5 




2509 


ECE5 


18 






2510 


ECE6 


69 


OB 




2511 


ECE8 


88 






2512 


ECE9 


10 


FA 




2513 


^ 








2514 


ECEB 


AO 


00 




2515 


EC ED 


8C 


OE 


03 


2516 


ECFO 


38 






2517 


ECFl 


E9 


07 




2518 


ECF3 


10 


03 




2519 


ECF5 


CE 


OE 


03 


2520 


ECF8 


18 






2521 


ECF9 


7D 


DO 


ED 


2522 


ECFC 


A8 






2523 


ECFD 


AD 


OE 


03 


2524 


EDOO 


7D 


Dl 


ED 


2525 










2526 


ED03 


60 






2527 










2528 










2529 










2530 










2531 










2532 


ED04 


C9 


7C 




2533 


ED06 


30 


04 




2534 


ED08 


38 






2535 


ED09 


E9 


7C 




2536 


EDOB 


60 






2537 


EDOC 


18 






2538 










2539 










2540 










2541 










2542 


EDOD 


69 


07 




2543 










2544 


EDOF 


60 
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ADC 


#$83 




. ENDIF 






DEY 






BPL 


HITIMR 




CLC 






ADC 


TEMPI 


FINDX: 


TAY 






LSR 


A 




LSR 


A 




LSR 


A 




ASL 


A 




SEC 






SBC 


#22 




TAX 






TYA 






AND 


#7 




TAY 






LDA 


#-11 


DOINTP: 


CLC 






ADC 


#11 




DEY 






BPL 


DOINTP 


ENINTP: 


LDY 


#0 




STY 


ADDCOR 




SEC 






SBC 


#7 




BPL 


PLUS 




DEC 


ADDCOR 


PLUS: 


CLC 






ADC 


POKTAB, X 




TAY 






LDA 


ADDCOR 




ADC 


POKTAB+1, X 



HI BYTE POKEY FREQ VALUE 
RTS 



/ACCUMULATE MULTIPLICATION 



i DONE? 

i TOTAL VCOUNT DIFFERENCE 
i SAVE AC CUM 



ADJUST TABLE INDEX 

DIVIDE INTERVAL BY 4 TO GET TABLE INDEX 

RESTORE /5CCUM 

PULL OFF 3 LO BITS OF INTERVAL 



ACCUMULATE INTERPOLATION CONSTANT 
INTERPOLATION CONSTANT COMPUTATION DONE? 

CLEAR ADDITION CORRECTION FLAG 
ADJUST INTERPOLATION CONSTANT 



ADD CONSTANT TO LO BYTE TABLE VALUE 
LO BYTE POKEY FREQ VALUE 

ADD CARRY TO HI BYTE TABLE VALUE 



ROUTINE TO ADJUST VCOUNT VALUE 



ADJUST 


: CMP 


#*7C 




BMI 


ADJl 




SEC 






SBC 


#*7C 




RTS 




ADJl: 


CLC 






. IF 


PALFLG 




ADC 


#*20 




. ENDIF 






. IF 


PALFLG- 1 




ADC 


#*7 




. ENDIF 






RTS 





; LARGER THAN '7C 
i YES, 



ERR LINE 


ADDR 


Bl 


B2 


B3 


2545 










2546 










2547 










2548 










2549 










2550 










2551 










2552 










2553 










2554 










2555 










2556 










2557 










2558 


EDiO 


A5 


11 




2559 


ED12 


DO 


03 




2560 


ED14 


4C 


AO 


ED 


2561 










2562 


ED17 


78 






2563 










2564 


ED18 


AD 


17 


03 


2565 


EDIB 


DO 


02 




2566 


EDID 


FO 


25 




2567 










2568 


EDIF 


AD 


OF 


D2 


2569 


ED22 


29 


10 




2570 


ED24 


DO 


EA 




2571 


ED26 


8D 


16 


03 


2572 


ED29 


AE 


OB 


D4 


2573 


ED2C 


A4 


14 




2574 


ED2E 


8E 


OC 


03 


2575 


ED31 


8C 


OD 


03 


2576 










2577 


ED34 


A2 


01 




2578 


ED36 


8E 


15 


03 


2579 


ED39 


AO 


OA 




2580 


ED3B 


A5 


11 




2581 


ED3D 


FO 


61 




2582 










2583 


ED3F 


AD 


17 


03 


2584 


ED42 


DO 


04 




2585 


ED44 


58 






2586 


ED45 


4C 


OA 


EB 


2587 










2588 


ED48 


AD 


OF 


D2 


2589 


ED4B 


29 


10 




2590 


ED4D 


CD 


16 


03 


2591 


ED50 


FO 


E9 




2592 


ED52 


8D 


16 


03 


2593 


ED55 


88 






2594 


ED56 


DO 


E3 




2595 










2596 


ED58 


CE 


15 


03 


2597 


ED5B 


30 


12 




2598 


ED5D 


AD 


OB 


D4 
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INITIAL BAUD RATE MEASUREMENT — USED TO SET THE 
BAUD RATE AT THE START OF A RECORD. 

IT IS ASSUMED THAT THE FIRST TWO BYTES OF EVERY 
RECORD ARE 'AA' HEX. 



JUMP IF BREAK KEY PRESSED 



BEGIN: 


LDA 


BRKKEY 




BNE 


NTBRK2 




JMP 


BROKE 


NTBRK2: 


SEI 




i 


LDA 


TIMFLO 




BNE 


OKTIMl 




BEQ 


TOUTl 


i 

OKTIMl: 


LDA 


SKSTAT 




AND 


#*10 




BNE 


BEGIN 




STA 


SAVIO 




LDX 


VCOUNT 




LDY 


RTCLOK+2 




STX 


TIMER 1 




STY 


TIMERl+1 


'' 


LDX 


#1 




STX 


TEMP3 




LDY 


#10 


COUNT: 


LDA 


BRKKEY 




BEQ 


BROKE 


' 


LDA 


TIMFLG 




BNE 


OKTIMR 


TOUTl: 


CLI 






JMP 


TOUT 


OKTIMR: 


LDA 


SKSTAT 




AND 


#*10 




CMP 


SAVIO 




BEQ 


COUNT 




STA 


SAVIO 




DEY 






BNE 


COUNT 




DEC 


TEMP3 




BMI 


OOREAD 




LDA 


VCOUNT 



BRANCH IF NOT TIMED OUT 
BRANCH IF TIME OUT 



iREAD SERIAL PORT 

; start bit? 

jSave ser. data in 

iread vertical line counter 

i read lo byte of vblank clock 

isave initial timer value 

;set mode flag 

iset bit counter for 10 bits 

; branch if break key pressed 

; branch if not timed out 
; branch if time out 



iREAD SERIAL PORT 
iDATA IN CHANGED YET? 

; YES I SAVE SER. DATA IN 
iDECR. BIT COUNTER 
; DONE? 

i YESi 

iDONE WITH BOTH MODES? 



:rr line 


ADDR 


Bl 


B2 


B3 B4 


2599 


ED60 


A4 


14 




2600 


ED62 


20 


A3 


EC 


2601 


ED65 


8C 


EE 


02 


2602 


ED68 


8D 


EF 


02 


2603 


ED6B 


AO 


09 




2604 


ED6D 


DO 


CC 




2605 










2606 


ED6F 


AD 


EE 


02 


2607 


ED72 


8D 


04 


D2 


2608 


ED75 


AD 


EF 


02 


2609 


ED78 


8D 


06 


D2 


2610 


ED7B 


A9 


00 




2611 


ED7D 


8D 


OF 


D2 


2612 


ED80 


AD 


32 


02 


2613 


ED83 


8D 


OF 


D2 


2614 


ED86 


A9 


55 




2615 


ED88 


91 


32 




2616 


ED8A 


C8 






2617 


ED8B 


91 


32 




2618 


ED8D 


A9 


AA 




2619 


ED8F 


85 


31 




2620 


ED91 


18 






2621 


ED92 


A5 


32 




2622 


ED94 


69 


02 




2623 


ED96 


85 


32 




2624 


ED98 


A5 


33 




2625 


ED9A 


69 


00 




2626 


ED9C 


85 


33 




2627 


ED9E 


58 






2628 


ED9F 


60 






2629 










2630 










2631 










2632 


EDAO 


20 


5F 


EC 


2633 


EDA3 


A9 


3C 




2634 


EDA5 


8D 


02 


D3 


2635 


EDA8 


8D 


03 


D3 


2636 










2637 


EDAB 


A9 


80 




2638 


EDAD 


85 


30 




2639 










2640 


EDAF 


AE 


18 


03 


2641 


EDB2 


9A 






2642 










2643 


EDB'3 


C6 


11 




2644 


EDB5 


58 






2645 










2646 


EDB6 


4C 


OD 


EA 


2647 










2648 










2649 










2650 










2651 










2652 


EDB9 


A9 


EC 
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LDY 


RTCLOK+2 


JSR 


COMPUT 


STY 


CBAUDL 


STA 


CBAUDH 


LDY 


#9 


BNE 


COUNT 


GOREAD: LDA 


CBAUDL 


STA 


AUDF3 


LDA 


CBAUDH 


STA 


AUDF4 


LDA 


#0 


STA 


SKSTAT 


LDA 


SSKCTL 


STA 


SKSTAT 


LDA 


#*55 


STA 


(BUFRLO), Y 


INY 




STA 


( BUFRLO ) , Y 


LDA 


#*AA 


STA 


CHKSUM 


CLC 




LDA 


BUFRLO 


ADC 


#2 


STA 


BUFRLO 


LDA 


BUFRHI 


ADC 


#0 


STA 


BUFRHI 


CLI 




RTS 




BROKE: JSR 


SENDDS 


LDA 


#mTRST 


STA 


PACTL 


STA 


PBCTL 


LDA 


#BRKABT 


STA 


STATUS 


LDX 


STACKP 


TXS 




DEC 


BRKKEY 


CLI 




JMP 


RETURN 



J READ TIMER LO & HI BYTES 
;N0, COMPUTE BAUD RATE 

; SET BAUD RATE INTO RAM CELLS 
;SET BIT COUNTER FOR 9 BITS 



; SET POKEY FREQ REGS FOR BAUD RATE 

; INIT. POKEY SERIAL PORT 

; STORE '$55' AS FIRST RCV. BUFFER 

; STORE CHECKSUM FOR 2 BYTES OF '*AA' 



; INCR. BUFFER POINTER BY 1 



BREAK KEY WAS PRESSED, SO PREPARE 

TO RETURN 

TURN OFF MOTOR 

RAISE NOT COMMAND LINE 



; STORE BREAK ABORT STATUS CODE 



; RESTORE STACK POINTER 

; SET BREAK KEY FLAG TO NONZERO 
; ALLOW IRQ'S 



; GO RETURN 



SETVBX: LDA 



#JTADRL 



/STORE TIME OUT ROUTINE ADDRESS 



ERR LINE ADDR Bl B2 B3 B4 
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2653 


EDBB 


8D 


26 02 


2654 


EDBE 


A9 


EB 


2655 


EDCO 


8D 


27 02 


2657 


EDC3 


A9 


01 


2658 








2659 


EDO 5 


78 




2660 


EDC6 


20 


5C E4 


2661 


EDC9 


A9 


01 


2662 


EDCB 


8D 


17 03 


2663 


EDGE 


58 




2664 


EDCF 


60 




2665 








2666 








2667 








2668 








2669 








2670 








2671 








2672 








2673 








2674 








2675 








2676 








2677 








2678 








2679 








2680 








2681 








2682 








2683 








2684 








2685 








2686 








2687 








2688 








2689 








2690 








2691 








2692 








2693 








2694 








2695 








2696 








2697 








2698 








2699 


EDDO 


E8 


03 


2700 


EDD2 


43 


04 


2701 


EDD4 


9E 


04 


2702 


EDD6 


F9 


04 


2703 


EDD8 


54 


05 


2704 


EDDA 


AF 


05 


2705 


EDDC 


OA 


06 


2706 


EDDE 


65 


06 



STA 


CDTMAl 


LDA 


#JTADRH 


STA 


CDTMAl+1 



LDA 



#1 



SEI 




JSR 


SETVBV 


LDA 


#1 


STA 


TIMFLO 


CLI 




RTS 





i SET FOR TIMER 1 

THE SETVBL ROUTINE NEEDS THIS TO CUT SHORT 

ANY VBLANKS THAT OCCUR 

SET FOR TIMER 1 

SET FLAG TO NOT TIMED OUT 



'VCOUNT' INTERVAL TIMER MEASUREMENT — TO — POKEY FREQ REG VALUE 
CONVERSION TABLE 



THE VALUES STORED IN THE TABLE ARE 'AUDF+7'. 

THE FOLLOWING FORMULAS WERE USED TO DETERMINE THE TABLE VALUES: 

F OUT= F IN/(2*(AUDF+M) ) , WHERE F IN=1. 78979 MHZ. fy. M=7 

FROM THIS WAS DERIVED THE FORMULA USED TO COMPUTE THE 
TABLE VALUES BASED ON A MEASUREMENT OF THE PERIOD BY 
AN INTERVAL OF THE 'VCOUNT' TIMER. 

AUDF+7=< 11. 365167 )*T OUT, WHERE T OUT=# OF COUNTS 
(127 USEC. RESOLUTION) OF 'VCOUNT' FOR 1 
CHARACTER TIME (10 BIT TIMES). 



POKTAB: 



WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 



AUDF+7 

*27C 
*2D7 
*332 
*38D 
*3E8 
*443 
*49E 
*4F9 
*554 
*5AF 
$60A 
$665 



BAUD RATE 

1407 

1231 

1094 

985 

895 

820 

757 

703 

656 

615 

579 

547 



VCOUNT INTERVAL 

56 

64 

72 

80 

88 

96 

104 

112 

120 

128 

136 

144 



ERR LINE ADDR Bl B2 B3 B4 



SIO ( SERIAL BUS INPUT /OUTPUT CONTROLLER ) 
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2707 EDEO CO 06 

2708 EDE2 lA 07 

2709 EDE4 75 07 

2710 EDE6 DO 07 
2711 

2712 

2713 

2714 

2715 

2716 

2717 

2718 

2719 

2720 

2721 

2722 

2723 

2724 

2725 EDE8 

2726 

2727 0014 02 



WORD 


*6C0 


WORD 


$7iA 


WORD 


*775 


WORD 


*7D0 


WORD 


*82B 


WORD 


*886 


WORD 


*8E1 


WORD 


*93C 


WORD 


*997 


WORD 


*9F2 


WORD 


$A4D 


WORD 


*AA8 


WORD 


*B03 



; 518 
i492 
i 469 
; 447 
; 428 
; 410 
; 394 
;379 
; 365 
;352 
;339 
;328 
;318 



152 
160 
168 
176 
184 
192 
200 
208 
216 
224 
232 
240 
248 



CRNTP3 =* 

*=*14 
SIOSPR: .BYTE DSK0RG-CRNTP3 ; -^GSIOL IS TOO LONG 



ERR LINE ADDR Bl B2 B3 B4 



SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) 
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0002 
OOEA 



0031 
0050 



0053 
0021 
0000 
0040 
0080 



2728 
2729 
2730 
2731 
2732 
2733 
2734 
2735 
2736 
2737 
2738 
2739 
2740 
2741 
2742 
2743 
2744 
2745 
2746 
2747 
2748 
2749 
2750 
2751 
2752 
2753 
2754 
2755 
2756 
2757 
2758 

2759 E450 4C EA ED 

2760 E453 4C FO ED 
2761 

2762 
2763 
2764 
2765 
2766 
2767 
2768 
2769 
2770 
2771 
2772 
2773 
2774 
2775 
2776 
2777 
2778 
2779 
2780 
2781 



TITLE 'DISK ***** DISKP. SRC ***** 3/9/79 ***** 4:00:00 P.M. 



STATVH = 
STATVL = 



DVSTAT/256 

<-256)*STATVH+DVSTAT i STATUS POINTER 



CONSTANT EQUATES 



DISKID 


= 


*31 


PUTSEC 


=: 


*50 


i READ 


= 


*52 


} WRITE 


= 


*57 


STATC 


= 


$53 


FOMAT 


= 


*21 


NODAT 


=s 





OETDAT 


= 


*40 


PUTDAT 

i 
i 


VECTORS 
»=*E450 


*80 




JMP 


DINIT 




JMP 


DSKIF 



CONSTANTS 
*=DSKORG 



SERIAL BUS DISK I. D. 

DISK PUT SECTOR DCB COMMAND 

DISK GET SECTOR DCB COMMAND 

DISK PUT SECTOR WITH READ CHECK DCB COMMAND 

DISK STATUS DCB COMMAND 

DISK FORMAT DCB COMMAND ! ! ! ! ! ***** 

SIO COMMAND FOR "NO DATA" OPERATION 

SIO COMMAND FOR "DATA FROM DEVICE" 

SIO COMMAND FOR "DATA TO DEVICE" 



; DISK INIT. VECTOR 

iDISK INTERFACE ENTRY POINT 



****«***#**#*♦*»**»***»***»**#**»*#******#***##**»»******»**»****»***** 

DISK INTERFACE ROUTINE STARTS HERE 
*»****«*****«****#**«**««*«#***«*****««*«»********««*****«*****«***««** 



LINE 


ADDR 


Bl 


B2 


B3 


2782 










2783 










2784 










2785 










2786 










2787 










2788 


EDEA 


A9 


AO 




2789 


EDEC 


8D 


46 


02 


2790 


EDEF 


60 






2791 










2792 










2793 










2794 










2795 










2796 


EDFO 


A9 


31 




2797 


EDF2 


8D 


00 


03 


2798 


EDF5 


AD 


46 


02 


2799 


EDF8 


AE 


02 


03 


2800 


EDFB 


EO 


21 




2801 


EDFD 


FO 


02 




2802 


EDFF 


A9 


07 




2803 


EEOl 


8D 


06 


03 


2804 


EE04 


A2 


40 




2805 


EE06 


AO 


80 




2806 


EE08 


AD 


02 


03 


2807 


EEOB 


C9 


57 




2808 


EEOD 


DO 


02 




2809 


EEOF 


A2 


80 




2810 


EEll 


C9 


53 




2811 


EE13 


DO 


OC 




2812 


EE15 


A9 


EA 




2813 


EE17 


8D 


04 


03 


2814 


EEIA 


A9 


02 




2815 


EEIC 


8D 


05 


03 


2816 


EEIF 


AO 


04 




2817 


EE21 


8E 


03 


03 


2818 


EE24 


8C 


08 


03 


2819 


EE27 


A9 


00 




2820 


EE29 


8D 


09 


03 


2821 


EE2C 


20 


59 


E4 


2822 


EE2F 


10 


01 




2823 


EE31 


60 






2824 


EE32 


AD 


02 


03 


2825 


EE35 


C9 


53 




2826 


EE37 


DO 


OA 




2827 


EE39 


20 


6D 


EE 


2828 


EE3C 


AO 


02 




2829 


EE3E 


Bl 


15 




2830 


EE40 


8D 


46 


02 


2831 


EE43 


AD 


02 


03 


2832 


EE46 


C9 


21 




2833 


EE48 


DO 


IF 




2834 


EE4A 


20 


6D 


EE 


2835 


EE4D 


AO 


FE 
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DISK INTERFACE INITIALIZATION ROUTINE 



DINIT: 



LDA 
STA 
RTS 



#160 
DSKTIM 



;SET INITIAL DISK TIMEOUT TO 160 SEC 



DISK INTERFACE ENTRY POINT 



DSKIF: LDA 
STA 
LDA 
LDX 
CPX 
BEQ 
LDA 

PUTDTO: STA 
LDX 
LDY 
LDA 
CMP 
BNE 
LDX 

CKSTC: CMP 
BNE 
LDA 
STA 
LDA 
STA 
LDY 

PUTCNT: STX 
STY 
LDA 
STA 
JSR 
BPL 
RTS 

GOODST: LDA 
CMP 
BNE 
JSR 
LDY 
LDA 
STA 

PUTBC: LDA 
CMP 
BNE 

FMTD: JSR 
LDY 



#DISKID 

DDEVIC 

DSKTIM 

DCOMND 

#FOMAT 

PUTDTO 

#7 

DTIMLO 

#GETDAT 

#*80 

DCOMND 

#WRITE 

CKSTC 

#PUTDAT 

#STATC 

PUTCNT 

#STATVL 

DBUFLO 

#STATVH 

DBUFHI 

«4 

DSTATS 

DBYTLO 

#0 

DBYTHI 

SIOV 

GOODST 

DCOMND 

#STATC 

PUTBC 

PUTADR 

#2 

< BUFADR ) - 

DSKTIM 

DCOMND 

#FOMAT 

ENDDIF 

PUTADR 

#*FE 



;SET SERIAL BUS I. D IN DCB 



; IS COMMAND A FORMAT COMMAND? 

NO, SET TIMEOUT TO 7 SECS. 

PUT DISK TIMEOUT IN DCB 

SET "GET DATA" COMMAND FOR SIO 

SET BYTE COUNT TO 128 

READ COMMAND IN DCB 

IS COMMAND A "PUT SECTOR" COMMAND? 

; YES, SET "PUT DATA" COMMAND FOR SIO 
; IS COMMAND A STATUS COMMAND? 



SET BUFFER ADDR TO GLOBAL STATUS BUFFER 

YES, SET BYTE COUNT TO 4 

PUT STATUS COMMAND FOR SIO IN DCB 



PUT BYTE COUNT IN DCB 

CALL SERIAL I/O. 

NO ERROR 

NO, GO BACK 

READ THE COMMAND 

WAS IT A STATUS COMMAND? 

PUT BUFFER ADDR IN TEMP REG. 

READ DISK TIMEOUT VALUE BYTE OF STATUS 
PUT IT IN DISK TIMEOUT REG. 

WAS COMMAND A FORMAT COMMAND? 

YES, PUT BUFFER ADDR INTO TEMP REG 
SET BUFFER POINTER 



LINE 


ADDR 


Bl 


B2 


B3 B4 


DISK 


»»*»* DISKP. SRC »»*** 3/9/79 »»*»» 4:00:00 PAGE 


2836 


EE4F 


C8 




TWICE: 


I NY 






2837 


EE50 


C8 








I NY 




; I NCR BUFFER POINTER BY 2 


2838 


EE51 


51 


15 


RDBAD: 


LDA 


( BUFADR ) 


, Y i READ LO BYTE BAD SECTOR DATA 


2839 


EE53 


C9 


FF 






CMP 


#*FF 




2840 


EE55 


DO 


F8 






BNE 


TWICE 


; IS IT "FF" ? 


2841 


EE57 


C8 








I NY 




; YES, 


2842 


EE58 


Bl 


15 






LDA 


( BUFADR ) 


, Y i READ HI BYTE BAD SECTOR DATA 


2843 


EE5A 


C8 








I NY 






2844 


EE5B 


C9 


FF 






CMP 


#*FF 




2845 


EE5D 


DO 


F2 






BNE 


RDBAD 


; IS IT "FF" ? 


2846 


EE5F 


88 








DEY 






2847 


EE60 


88 








DEY 




; YES, 


2848 


EE61 


8C 


08 


03 




STY 


DBYTLO 


;PUT BAD SECTOR BYTE COUNT INTO DCB 


2849 


EE64 


A9 


00 






LDA 


#0 




2850 


EE66 


8D 


09 


03 




STA 


DBYTHI 




2851 


EE69 


AC 


03 


03 ENDDIF: 


LDY 


DSTATS 




2852 


EE6C 


60 








RTS 






2853 


















2854 


















2855 


















2856 


















2857 












SUB 


R U T I 


N E S 


2858 


















2859 










' 








2860 












PUT BUFFER ADDR 


FROM DCB INTO TEMP REG 


2861 


















2862 


EE6D 


AD 


04 


03 1 


=UTADR: 


LDA 


DBUFLQ 




2863 


EE70 


85 


15 






STA 


BUFADR 




2864 


EE72 


AD 


05 


03 




LDA 


DBUFHI 




2865 


EE75 


85 


16 






STA 


BUFADR+1 


;PUT BUFFER ADDR IN TEMP REG 


2866 


EE77 


60 








RTS 






2867 










»•»**************************♦»******«**********#*#*#****«*•«•»*»■»* 


2868 


















2869 


















2870 












SPARE 


BYTE OR MODULE TOO LONG FLAG 


2871 


















2872 


EE78 








:rntp4 


= 


* 




2873 


















2874 












*=*14 






2875 


0014 


00 






DSKSPR: 


. BYTE 


PRN0RG-CRNTP4 ; '^GDISKP TOO LONG 


2876 



















63 



ERR LINE 


ADDR 


Bl 


B2 B3 


2877 








2878 








2879 








2880 








2881 








2882 








2883 








2884 








2885 








2886 








2887 








2888 








2889 








2890 








2891 








2892 


0002 






2893 


0028 






2894 


0014 






2895 


OOID 






2896 


0040 






2897 








2898 


0057 






2899 


0020 






2900 


004E 






2901 


0044 






2902 


0053 






2903 








2904 








2905 








2906 








2907 








2908 








2909 








2910 








2911 








2912 


E430 


9E 


EE 


2913 


E432 


DB 


EE 


2914 


E434 


9D 


EE 


2915 


E436 


A6 


EE 


2916 


E438 


80 


EE 


2917 


E43A 


9D 


EE 


2918 


E43C 


4C 


78 EE 


2919 


E43F 


00 




2920 








2921 








2922 








2923 








2924 








2925 








2926 








2927 








2928 








2929 








2930 
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. PAGE 

.TITLE 'PRINTER ***** PRINTP. SRC ***** 3/9/79 ***** 4:00:00 P 



DEVICE NUMBER OR CODE EQUATES 



OPNOUT 

NBUFSZ 

DBUFSZ 

SBUFSZ 

PDEVN 

i STATC 

WRITEC 

SPACE 

N 

D 

S 



*2 

40 

20 

29 

*40 

$53 

*57 

*20 

*4E 

*44 

*53 



lOCB OPEN FOR OUTPUT COMMAND 
PRINT NORMAL BUFFER SIZE 
PRINT DOUBLE BUFFFER SIZE 
PRINT SIDEWAYS BUFFER SIZE 
PRINTER DEVICE NUMBER 
DCB STATUS COMMAND CODE 
DCB WRITE COMMAND 
ASCII SPACE CHAR. 
ASCII "N" CHAR. 
ASCII "D" CHAR. 
ASCII "S" CHAR. 



PRINTER HANDLER ENTRY POINTS 



*=*E430 



. WORD 


PHOPEN-1 


PRINTER HANDLER OPEN 


. WORD 


PHCLOS-1 


PH CLOSE 


. WORD 


BADST-1 


PH READ 


. WORD 


PHWRIT-1 


PH WRITE 


. WORD 


PHSTAT-1 


PH STATUS 


. WORD 


BADST-1 


PH SPECIAL 


JMP 


PHINIT 


PH INIT. 


. BYTE 





ROM FILLER 



*=PRNORG 



PRINTER HANDLER INITIALIZATION ROUTINE 



ERR LINE 


ADDR 


Bl 


B2 


B3 


2931 










2932 


EE78 


A9 


IE 




2933 


EE7A 


85 


IC 




2934 


EE7C 


60 






2935 










2936 










2937 










2938 










2939 


EE7D 


EA 


02 




2940 


EE7F 


CO 


03 




2941 










2942 










2943 










2944 










2945 










2946 










2947 










2948 










2949 










2950 










2951 










2952 










2953 










2954 


EE81 


A9 


04 




2955 


EE83 


85 


IE 




2956 


EE85 


AE 


7D 


EE 


2957 


EE88 


AC 


7E 


EE 


2958 


EESB 


A9 


53 




2959 


EE8D 


8D 


02 


03 


2960 


EE90 


8D 


OA 


03 


2961 


EE93 


20 


E6 


EE 


2962 


EE96 


20 


59 


E4 


2963 


EE99 


30 


03 




2964 


EE9B 


20 


14 


EF 


2965 


EE9E 


60 






2966 










2967 










2968 










2969 










2970 










2971 










2972 


EE9F 


20 


81 


EE 


2973 


EEA2 


A9 


00 




2974 


EEA4 


85 


ID 




2975 


EEA6 


60 






2976 










2977 










2978 










2979 










2980 










2981 










2982 


EEA7 


85 


IF 




2983 


EEA9 


20 


lA 


EF 


2984 


EEAC 


A6 


ID 
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PHINIT: LDA #30 

STA PTIMOT 
RTS 



; SET UP INITIAL PRINTER TIMEOUT OF 30 SEC. 



PRINTER HANDLER CONSTANTS 



PHSTLO: . WORD DVSTAT 
PHCHLO: . WORD PRNBUF 



; STATUS BUFFER POINTER 
i CHAR. BUFFER POINTER 



PRINTER HANDLER ROUTINES 



PRINTER HANDLER STATUS ROUTINE 



PHSTAT: 


LDA 


#4 




STA 


PBUFSZ 




LDX 


PHSTLO 




LDY 


PHSTLO+1 




LDA 


#STATC 




STA 


DCOMND 




STA 


DAUXl 




JSR 


SETDCB 




JSR 


SIOV 




BMI 


BADST 




JSR 


PHPUT 


BADST: 


RTS 





;SET BUFFER SIZE TO 4 BYTES 

SET POINTER TO STATUS BUFFER 
SET COMMAND TO "STATUS" 
SET STATUS COMMAND 

GO SETUP DCB 

SEND STATUS COMMAND 

GO IF ERROR 

YES, PUT STATUS INTO GLOBAL BUFFER. 



PRINTER HANDLER OPEN ROUTINE 

PHOPEN: JSR PHSTAT ; DO STATUS COMMAND TO SIO 

LDA #0 

STA PBPNT /CLEAR PRINT BUFFER POINTER 
RTS 



PRINTER HANDLER WRITE ROUTINE 



PHWRIT: STA 
JSR 
LDX 



PTEMP 

PRMODE 

PBPNT 



; SAVE ACCUM 

;G0 DETERMINE PRINT MODE 



ERR LINE ADDR Bl B2 B3 B4 
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2985 


EEAE 


A5 


IF 




2986 


EEBO 


9D 


CO 


03 


2987 


EEB3 


E8 






2988 


EEB4 


E4 


IE 




2989 


EEB6 


FO 


13 




2990 


EEB8 


86 


ID 




2991 


EEBA 


C9 


9B 




2992 


EEBC 


FO 


03 




2993 


EEBE 


AO 


01 




2994 


EECO 


60 






2995 


EECl 


A9 


20 




2996 


EEC3 


9D 


CO 


03 


2997 


EEC6 


E8 






2998 


EEC7 


E4 


IE 




2999 


EEC9 


DO 


F8 




3000 


EECB 


A9 


00 




3001 


EECD 


85 


ID 




3002 


EECF 


AE 


7F 


EE 


3003 


EED2 


AC 


80 


EE 


3004 


EED5 


20 


E6 


EE 


3005 


EED8 


20 


59 


E4 


3006 


EEDB 


60 






3007 










3008 










3009 










3010 










3011 










3012 










3013 


EEDC 


20 


lA 


EF 


3014 


EEDF 


A6 


ID 




3015 


EEEl 


DO 


DE 




3016 


EEE3 


AO 


01 




3017 


EEE5 


60 






3018 










3019 










3020 










3021 










3022 










3023 










3024 










3025 










3026 










3027 










3028 










3029 










3030 










3031 










3032 










3033 










3034 


EEE6 


8E 


04 


03 


3035 


EEE9 


8C 


05 


03 


3036 


EEEC 


A9 


40 




3037 


EEEE 


8D 


00 


03 


3038 


EEFl 


A9 


01 







LDA 


PTEMP 




STA 


PRNBUF/ X 




INX 






CPX 


PBUFSZ 




BEQ 


BUFFUL 




STX 


PBPNT 




CMP 


#CR 




BEQ 


BLFILL 




LDY 


#SUCCES 




RTS 




BLFILL: 


LDA 


#SPACE 


FILLBF: 


STA 
INX 


PRNBUF, X 




CPX 


PBUFSZ 




BNE 


FILLBF 


BUFFUL: 


LDA 


#0 




STA 


PBPNT 




LDX 


PHCHLO 




LDY 


PHCHLO+1 




JSR 


SETDCB 




JSR 


SIOV 




RTS 





; GET CHAR. SENT BY CIO 
;PUT CHAR. IN PRINT BUFFER 
; INCR. BUFFER POINTER 
; BUFFER POINTER=BUFFER SIZE? 

; SAVE BUFFER POINTER 

; IS CHAR. = EOL ? 

; IF YES, GO DO BLANK FILL. 

; PUT GOOD STATUS IN Y REG FOR CIO. 

; PUT BLANK IN ACCUM. 

; STORE IT IN PRINT BUFFER. 



i BUFFER BLANK FILLED? 

; CLEAR PRINT BUFFER POINTER 

iSET POINTER TO PRINT BUFFER 
i GO SETUP DCB 
/SEND PRINT COMMAND 
; YES. 



PRINTER HANDLER CLOSE ROUTINE 



PHCLOS: 


JSR 


PRMODE 




LDX 


PBPNT 




BNE 


BLFILL 




LDY 


#SUCCES 




RTS 





; GO DETERMINE PRINT MODE 



SUBROUTINES 



SET UP DCB TO CALL SIO 



SETDCB: 


STX 


DBUFLO 




STY 


DBUFHI 




LDA 


#PDEVN 




STA 


DDEVIC 




LDA 


#1 



iSET BUFFER POINTER 

i SET PRINTER BUS I.D. FOR DCB 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


3039 


EEF3 


8D 


01 


03 


3040 


EEF6 


A9 


80 




3041 


EEF8 


AE 


02 


03 


3042 


EEFB 


EO 


53 




3043 


EEFD 


DO 


02 




3044 


EEFF 


A9 


40 




3045 


EFOl 


8D 


03 


03 


3046 


EF04 


A5 


IE 




3047 


EF06 


8D 


08 


03 


3048 


EF09 


A9 


00 




3049 


EFOB 


8D 


09 


03 


3050 


EFOE 


A5 


IC 




3051 


EFIO 


8D 


06 


03 


3052 


EF13 


60 






3053 










3054 










3055 










3056 










3057 










3058 










3059 


EF14 


AD 


EC 


02 


3060 


EF17 


85 


IC 




3061 


EF19 


60 






3062 










3063 










3064 










3065 










3066 










3067 










3068 










3069 


EFIA 


AO 


57 




3070 


EFIC 


A5 


2B 




3071 


EFIE 


C? 


4E 




3072 


EF20 


DO 


04 




3073 


EF22 


A2 


28 




3074 


EF24 


DO 


OE 




3075 


EF26 


C9 


44 




3076 


EF28 


DO 


04 




3077 


EF2A 


A2 


14 




3078 


EF2C 


DO 


06 




3079 


EF2E 


C9 


53 




3080 


EF30 


DO 


OB 




3081 


EF32 


A2 


ID 




3082 


EF34 


86 


IE 




3083 


EF36 


8C 


02 


03 


3084 


EF39 


8D 


OA 


03 


3085 


EF3C 


60 






3086 


EF3D 


A9 


4E 




3087 


EF3F 


DO 


DD 




3088 










3089 










3090 










3091 










3092 











PRINTER ***** PRINTP. SRC ***** 3/9/79 ***** 4:00 

i SET UNIT NUMBER TO 1 

i DEVICE WILL EXPECT DATA 

; STATUS COMMAND? 

; EXPECT DATA FROM DEVICE 
; SET SIO MODE COMMAND. 

; SET LO BYTE COUNT 

;SET HI BYTE COUNT 

; SET DEVICE TIMEOUT COUNT 
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STA 


DUN IT 


LDA 


#*80 


LDX 


DCOMND 


CPX 


ttSTATC 


BNE 


PSIOC 


LDA 


#*40 


PSIOC: STA 


DSTATS 


LDA 


PBUFSZ 


STA 


DBYTLO 


LDA 


#0 


STA 


DBYTHI 


LDA 


PTIMOT 


STA 


DTIMLO 


RTS 





GET DEVICE TIMEOUT FROM STATUS ?y SAVE IT 



PHPUT: LDA 
STA 
RTS 



DVSTAT+2 
PTIMOT 



; SAVE DEVICE TIMEOUT 



DETERMINE PRINT MODE ?y. SETUP PRINT BUFFER SIZE, DCB PRINT 
COMMAND, fy. DCB AUXl FOR PRINT MODE 



; PUT WRITE COMMAND IN Y REG 
iREAD PRINT MODE 



PRMODE: 


LDY 


#WR I TEC 




LDA 


ICAX2Z 


CMODE: 


CMP 


#N 




BNE 


CDUBL 




LDX 


#NBUFSZ 




BNE 


SETBSZ 


CDUBL: 


CMP 


#D 




BNE 


CSIDE 




LDX 


#DBUFSZ 




BNE 


SETBSZ 


CSIDE: 


CMP 


#S 




BNE 


GOERR 




LDX 


#SBUFSZ 


SETBSZ: 


STX 


PBUFSZ 




STY 


DCOMND 




STA 


DAUXl 




RTS 




OOERR : 


LDA 


#N 




BNE 


CMODE 



i PRINT NORMAL ? 

; YES, SET NORMAL CHAR. BUFFER SIZE 



; PRINT DOUBLE? 

; YES, SET DOUBLE CHAR. BUFFER SIZE 

PRINT SIDEWAYS ? 

IF NOT, GO TO ERROR ROUTINE 

YES, SET SIDEWAYS BUFFER SIZE 

STORE PRINT BUFFER SIZE 

STORE DCB COMMAND 

STORE DCB AUXl PRINT MODE 

;SET DEFAULT PRINT MODE TO NORMAL 



*♦**********»************»**#**♦»***********»****»*********** 



SPARE BYTE OR MODULE TOO LONG FLAG 



LINE 


ADDR 


Bi B2 B3 B4 


3093 


EF41 




3094 






3095 






3096 






3097 


0014 


00 


3098 







PRINTER ***** PRINTP.SRC ***** 3/9/79 ***** 4:00 PAGE 68 
CRNTP5 = » 

i 

*=*14 
i 
PRNSPR: .BYTE CAS0RG-CRNTP5 i'^GPRINTP TOO LONG 



ERR LINE 


ADDR 


Bl 


B2 


B3 


B4 


3099 












3100 












3101 


0003 










3102 


OOFD 










3103 


0040 










3104 


0080 










3105 












3106 












3107 












3108 












3109 


OOFC 










3110 


OOFA 










3111 


OOFE 










3112 


OOFB 










3113 


0002 










3114 


0001 










3115 












3116 












3117 












3118 












3119 


E440 


4B 


EF 


2A 


FO 


3120 


E444 


D5 


EF 


OF 


FO 


3121 


E448 


27 


FO 


4A 


EF 


3122 


E44C 


4C 


41 


EF 




3123 


E44F 


00 








3124 












3125 












3126 












3127 












3128 












3129 












3130 


E47A 


4C 


E9 


EF 




3131 












3132 












3133 


E47D 


4C 


5D 


EF 




3134 












3135 












3136 












3137 












3138 












3139 












3140 












3141 


EF41 


A9 


CC 






3142 


EF43 


8D 


EE 


02 




3143 


EF46 


A9 


05 






3144 


EF48 


8D 


EF 


02 




3145 












3146 


EF4B 


60 









PRINTER ***** PRINTP.SRC ***** 3/9/79 ***** 4:00 

. PAGE 

.TITLE 'CASSET HANDLER 3/12 (DKliCASCV)' 

CBUFH = CASBUF/256 

CBUFL = (-256)*CBUFH+CASBUF 

SRSTA = $40 ;SIO READ STATUS 

SWSTA = *80 ;SIO WRITE STATUS 

MOTRGO = *34 

MOTRST = *3C 



PAGE 



69 



DTA 

DTI 

EOT 

HDR 

TONEl 

T0NE2 



*FC 

*FA 

*FE 

*FB 

2 

1 



DATA RECORD TYPE BYTE 

LAST DATA RECORD 

END OF TAPE 

HEADER 

CHANGE TO RECORD MODE TONE 

PRESS PLAY TONE 



*=CASETV 

. WORD OPENC-1, CLOSEC-1, OB YTE-1. PBYTE-1/ STATU- 1, SPECIAL-1 



JMP 
. BYTE 



INIT 




;ROM FILLER BYTE 



USED IN MONITP FOR CASSETTE BOOT 

*=RBLOKV 

JMP RBLOK 

*=CSOPIV 

JMP OPINP 



*=CASORG 

INIT ROUTINE 
INIT: 



SPECIAL: 



LDA #*CC 

ST A CBAUDL 

LDA #*05 

STA CBAUDH 

RTS 



i SET CASSET BAUD RATE TO 600 
; THATS ALL FOLKS 



ERR LINE ADDR Bi B2 B3 B4 
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3147 










3148 










3149 










3150 










3151 


EF4C 


A5 


2B 




3152 


EF4E 


85 


3E 




3153 


EF50 


A5 


2A 




3154 


EF52 


29 


OC 




3155 


EF54 


C9 


04 




3156 


EF56 


FO 


05 




3157 


EF58 


C9 


08 




3158 


EF5A 


FO 


39 




3159 


EF5C 


60 






3160 


EF5D 


A9 


00 




3161 


EF5F 


8D 


89 


02 


3162 


EF62 


85 


3F 




3163 


EF64 


A9 


01 




3164 


EF66 


20 


58 


FO 


3165 


EF69 


30 


24 




3166 


EF6B 


A9 


34 




3167 


EF6D 


8D 


02 


D3 


3168 










3169 










3170 










3171 










3172 










3173 


EF70 


AO 


40 




3174 


EF72 


A2 


02 




3175 










3176 


EF74 


A9 


03 




3177 


EF76 


8D 


2A 


02 


3178 


EF79 


20 


5C 


E4 


3179 


EF7C 


AD 


2A 


02 


3180 


EF7F 


DO 


FB 




3181 


EF81 


A9 


80 




3182 


EF83 


85 


3D 




3183 


EF85 


8D 


8A 


02 


3184 


EF88 


4C 


D3 


EF 


3185 










3186 










3187 










3188 


EF8B 


AO 


80 




3189 


EF8D 


C6 


11 




3190 


EF8F 


A9 


00 




3191 


EF91 


8D 


89 


02 


3192 


EF94 


60 






3193 










3194 


EF95 


A9 


80 




3195 


EF97 


8D 


89 


02 


3196 


EF9A 


A9 


02 




3197 


EF9C 


20 


58 


FO 


3198 


EF9F 


30 


EE 




3199 


EFAl 


A9 


CC 




3200 


EFA3 


8D 


04 


D2 



PAGE 



OPEN FUNCTION - WITH NO TIMING ADJUST 



OPENC : LDA 
STA 
LDA 
AND 
CMP 
BEQ 
CMP 
BEQ 
RTS 

OPINP: LDA 
STA 
STA 

SFH: LDA 
JSR 
BMI 
LDA 
STA 
. IF 
LDY 
LDX 

. ENDIF 
. IF 
LDY 
LDX 

. ENDIF 
LDA 
STA 
JSR 

WAITTM: LDA 
BNE 
LDA 
STA 
STA 
JMP 



ICAX2Z 

FTYPE 

ICAXIZ 

#*0C 

#*04 

OPINP 

#$08 

OPOUT 

#0 

WMODE 

FEOF 

#T0NE2 

BEEP 

OPNRTN 

#MOTRGO 

PACTL 

PALFLG 

#*E0 

#1 

PALFLG- 1 

#*40 

#2 

#3 

CDTMF3 

SETVBV 

CDTMF3 

WAITTM 

#*80 

BPTR 

BLIM 

OPOK 



OPEN FOR OUTPUT 



PBRK: LDY 
DEC 

OPNRTN: LDA 
STA 
RTS 



OPOUT: 



LDA 
STA 
LDA 
JSR 
BMI 
LDA 
STA 



#BRKABT 
BRKKEY 
#0 
WMODE 



#*80 

WMODE 

#T0NE1 

BEEP 

OPNRTN 

#*CC 

AUDF3 



; GET AX2 

iSAVE IT FOR FUTURE REFERENCE 

; IN AND OUT BITS 



iSEE IF OPEN FOR OUTPUT 

; IF ALREADY OPEN, RETURN LEAVING STATUS=*84 

SET READ MODE 

NO EOF YET 

TONE FOR PRESS PLAY 

GO BEEP 

IF ERROR DURING BEEP 

; TURN MOTOR ON 



; 5-31-79 9 SEC READ LEADER 



; SET UP VBLANK TIMER 

;WAIT FOR MOTOR TO COME UP TO SPEED 
iNEXT BYTE=NO BYTES IN BUFFER 



; OPEN OK 



BREAK KEY ABORT STATUS 
RESET BREAK KEY 
CLEAR WRITE MODE FLAG 

AND EXIT. 



SET WRITE MODE 

TELL USER TO TURN ON RECORD MODE 

IF ERROR DURING BEEP 

SET BAUD RATE 

WHICH SEEMS TO BE NESSECARY 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


3201 


EFA6 


A9 


05 




3202 


EFA8 


8D 


06 


D2 


3203 


EFAB 


A9 


60 




3204 


EFAD 


8D 


00 


03 


3205 


EFBO 


20 


68 


E4 


3206 


EFB3 


A9 


34 




3207 


EFB5 


8D 


02 


D3 


3208 


EFB8 


A9 


03 




3209 










3210 










3211 










3212 










3213 










3214 


EFBA 


A2 


04 




3215 


EFBC 


AO 


80 




3216 










3217 


EFBE 


20 


5C 


E4 


3218 


EFCl 


A9 


FF 




3219 


EFC3 


8D 


2A 


02 


3220 


EFC6 


A5 


11 




3221 


EFC8 


FO 


CI 




3222 


EFCA 


AD 


2A 


02 


3223 


EFCD 


DO 


F7 




3224 


EFCF 


A9 


00 




3225 


EFDl 


85 


3D 




3226 


EFD3 


AO 


01 




3227 


EFD5 


60 
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WDLR: 



OPOK: 



LDA 


#*05 


STA 


AUDF4 


LDA 


#*60 


STA 


DDEVIC 


JSR 


SENDEV 


LDA 


#ri0TR00 


STA 


PACTL 


LDA 


#3 


. IF 


PALFLG 


LDX 


#»3 


LDY 


#*C0 


. ENDIF 




. IF 


PALFLG- 1 


LDX 


#4 


LDY 


#*80 


. ENDIF 




JSR 


SETVBV 


LDA 


#*FF 


STA 


CDTMF3 


LDA 


BRKKEY 


BEQ 


PBRK 


LDA 


CDTMF3 


BNE 


WDLR 


LDA 


#0 


STA 


BPTR 


LDY 


#SUCCES 


RTS 





;FOR SOME OBSCURE REASON 



;TELL POKEY TO WRITE MARKS 
; WRITE 5 SEC BLANK TAPE 



; 5/30/79 20 SEC LEADER 



IF BREAK DURING WRITE LEADER 



/ INIT BUFFER POINTER 



ERR LINE 


ADDR 


Bi 


B2 


B3 


3228 










3229 










3230 










3231 










3232 


EFD6 


A5 


3F 




3233 


EFD8 


30 


33 




3234 


EFDA 


A6 


3D 




3235 


EFDC 


EC 


8A 


02 


3236 


EFDF 


FO 


08 




3237 


EFEl 


BD 


00 


04 


3238 


EFE4 


E6 


3D 




3239 


EFE6 


AO 


01 




3240 


EFE8 


60 






3241 


EFE9 


A9 


52 




3242 


EFEB 


20 


95 


FO 


3243 


EFEE 


78 






3244 


EFEF 


30 


F7 




3245 


EFFl 


A9 


00 




3246 


EFF3 


85 


3D 




3247 


EFF5 


A2 


80 




3248 


EFF7 


AD 


FF 


03 


3249 


EFFA 


C9 


FE 




3250 


EFFC 


FO 


OD 




3251 


EFFE 


C9 


FA 




3252 


FOOO 


DO 


03 




3253 


F002 


AE 


7F 


04 


3254 


F005 


8E 


8A 


02 


3255 


F008 


4C 


D6 


EF 


3256 


FOOD 


C6 


3F 




3257 


FOOD 


AO 


88 




3258 


FOOF 


60 
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; GET 


BYTE 




GBYTE: 


LDA 


FEOF 




BMI 


ISEOF 




LDX 


BPTR 




CPX 


BLIM 




BEQ 


RBLOK 




LDA 


CASBUF+3, X 




INC 


BPTR 




LDY 


#SUCCES 


OBX: 


RTS 




RBLOK: 


LDA 


#'R 




JSR 


SIOSB 




TYA 






BMI 


GBX 




LDA 


#0 




STA 


BPTR 




LDX 


#*80 




LDA 


CASBUF+2 




CMP 


#EOT 




BEQ 


ATEOF 




CMP 


#DT1 




BNE 


NLR 




LDX 


CASBUF+i30 


NLR; 


STX 


BLIM 




JMP 


GBYTE 


ATEOF: 


DEC 


FEOF 


ISEOF: 


LDY 
RTS 


#EOFERR 



IF AT EOF ALREADY 
RETURN EOF STATUS 
BUFFER POINTER 
IF END OF BUFFER 
READ ANOTHER BLOCK 
GET NEXT BYTE 
BUMP POINTER 
OK STATUS 

; READ OPCCDE 

i SIO ON SYS BUF 

; IF SIO ERRORS, RETURN 

; RESET POINTER 
; DEFAULT # BYTES 



i IF HEADER, GO READ AGAIN 
i IF LAST DATA REC 

; LAST DATA RECORD, GET # BYTES 



GET NEXT BYTE 
SET FEOF 
ENDFILE STATUS 



LINE 


ADDR 


Bl 


B2 


B3 


3259 










3260 










3261 










3262 










3263 


FOlO 


A6 


3D 




3264 


F012 


9D 


00 


04 


3265 


F015 


E6 


3D 




3266 


F017 


AO 


01 




3267 


F019 


EO 


7F 




3268 


FOIB 


FO 


01 




3269 


FOID 


60 






3270 










3271 


FOIE 


A9 


FC 




3272 


F020 


20 


D2 


FO 


3273 


F023 


A9 


00 




3274 


F025 


85 


3D 




3275 


F027 


60 
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PUT BYTE TO BUFFER 



YTE: 


LDX 


BPTR 




STA 


CASBUF+3, X 




INC 


BPTR 




LDY 


#SUCCES 




CPX 


#127 




BEQ 


*+3 




RTS 




WRITE 


OUT 


THE BUFFER 




LDA 


#DTA 




JSR 


WSIOSB 




LDA 


#0 




STA 


BPTR 



BUFFER POINTER 
STORE CHAR AWAY 
BUMP POINTER 
OK STATUS 
IF BUFFER FULL 



RECORD TYPE = DATA 

DO WRITE ON SYSTEM BUFFER 

RESET BUFFER POINTER 



RTS 



.EXIT. 



ERR LINE ADDR Bi B2 B3 B4 CASSET HANDLER 3/12 <DK1:CASCV) PAGE 74 

3276 . PAGE 

3277 ; 

3278 ; STATUS - RETURN STATUS INFO THRU DVSTAT 

3279 } 

3280 F028 AO 01 STATU: LDY #SUCCES 

3281 F02A 60 RTS 



ERR LINE 


ADDR 


Bi 


B2 


B3 


3282 










3283 










3284 










3285 










3286 


F02B 


AD 


89 


02 


3287 


F02E 


30 


08 




3288 










3289 


F030 


AO 


01 




3290 


F032 


A9 


3C 




3291 


F034 


8D 


02 


D3 


3292 


F037 


60 






3293 


F038 


A6 


3D 




3294 


F03A 


FO 


OA 




3295 


F03C 


8E 


7F 


04 


3296 


F03F 


A9 


FA 




3297 


F041 


20 


D2 


FO 


3298 


F044 


30 


EC 




3299 


F046 


A2 


7F 




3300 


F048 


A9 


00 




3301 


F04A 


9D 


00 


04 


3302 


F04D 


CA 






3303 


F04E 


10 


FA 




3304 


F050 


A9 


FE 




3305 


F052 


20 


D2 


FO 


3306 


F055 


4C 


32 


FO 
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; CLOSE 






CLOSEC : 


LDA 


WMODE 




BMI 


CLWRT 


; CLOSE 


FOR 


READ - FLAG CL 




LDY 


ttSUCCES 


FCAX: 


LDA 


#MOTRST 




STA 


PACTL 




RTS 




CLWRT: 


LDX 


BPTR 




BEQ 


WTLR 




STX 


CASBUF+130 




LDA 


#DT1 




JSR 


WSIOSB 




BMI 


FCAX 


WTLR: 


LDX 


#127 




LDA 


#0 


ZTBUF: 


STA 
DEX 


CASBUF+3, X 




BPL 


ZTBUF 




LDA 


#EOT 




JSR 


WSIOSB 




JMP 


FCAX 



iSEE IF WRITING 
,G0 CLOSE FOR WRITE 
>ED 

; SUCCESSFULL 
i STOP THE MOTOR IN CASE WAS SHORT 



IRG MODE 



BUFFER POINTER 

IF NO DATA BYTES IN BUFFER, 

WRITE TO LAST RECORD 

REC TYPE 

WRITE OUT USER BUFFER 

GO IF ERROR 

ZERO BUFFER 



; WRITE EOT RECORD 
iFLAG CLOSED AND EXIT 



NO DTI REC 



ERR LINE 


ADDR 


Bl 


B2 


B3 


3307 










3308 










3309 










3310 










3311 










3312 










3313 










3314 


F058 


85 


40 




3315 


F05A 


A5 


14 




3316 


F05C 


18 






3317 










3318 










3319 










3320 










3321 


F05D 


69 


IE 




3322 










3323 


F05F 


AA 






3324 


F060 


A9 


FF 




3325 


F062 


8D 


IF 


DO 


3326 


F065 


A9 


00 




3327 


F067 


AO 


FO 




3328 


F069 


88 






3329 


F06A 


DO 


FD 




3330 


F06C 


8D 


IF 


DO 


3331 


F06F 


AO 


FO 




3332 


F071 


88 






3333 


F072 


DO 


FD 




3334 


F074 


E4 


14 




3335 


F076 


DO 


E8 




3336 


F078 


C6 


40 




3337 


F07A 


FO 


OB 




3338 


F07C 


8A 






3339 


F07D 


18 






3340 










3341 










3342 










3343 










3344 


F07E 


69 


OA 




3345 










3346 


F080 


AA 






3347 


FOSl 


E4 


14 




3348 


F083 


DO 


FC 




3349 


F085 


FO 


D3 




3350 


F087 


20 


8C 


FO 


3351 


F08A 


98 






3352 


F08B 


60 






3353 


F08C 


AD 


25 


E4 


3354 


F08F 


48 






3355 


F090 


AD 


24 


E4 


3356 


F093 


48 






3357 


F094 


60 






3358 










3359 










3360 
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SUBROUTINES 

BEEP - GENERATE TONE ON KEYBOARD SPEAKER 
ON ENTRY A= FREQ 



BEEP: STA 

BEEPl: LDA 
CLC 
. IF 
ADC 

. ENDIF 
. IF 
ADC 

. ENDIF 
TAX 

WFL: LDA 
STA 
LDA 
LDY 
DEY 
BNE 
STA 
LDY 
DEY 
BNE 
CPX 
BNE 
DEC 
BEQ 
TXA 
CLC 
. IF 
ADC 

. ENDIF 
. IF 
ADC 

. ENDIF 
TAX 
CPX 
BNE 
BEQ 

WFAK: JSR 
TYA 
RTS 

WFAKl: LDA 
PHA 
LDA 
PHA 
RTS 



FREQ 
RTCLOK+2 

PALFLG 
#25 

PALFLG- 1 
#30 



#*FF 
CONSOL 
#0 
#*F0 

*-l 

CONSOL 

#*F0 

*-l 

RTCLOK+2 

WFL 

FREQ 

WFAK 



PALFLG 
#8 

PALFLG- 1 
#10 



RTCLOK+2 
*-2 
BEEP! 
WFAKl 



KEYBDV+5 
KEYBDV+4 



i CURRENT CLOCK 



; 1 SEC TONE 



; TURN ON SPEAKER 



i TURN OFF SPEAKER 



; SEE IF 1 SEC IS UP YET 

; COUNT BEEPS 

; IF ALL DONE GO WAIT FOR KEY 



; UNCOND GO BEEP AGIN 

iUSE SIMULATED "JMP (KGETCH) 



{SIMULATE "JMP (KGETCH)" 



SIOSB - CALL SIQ ON SYSTEM BUFFER 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


3361 


F095 


8D 


02 


03 


3362 


F098 


A9 


00 




3363 


F09A 


8D 


09 


03 


3364 


F09D 


A9 


83 




3365 


F09F 


8D 


08 


03 


3366 


F0A2 


A9 


03 




3367 


F0A4 


3D 


05 


03 


3368 


F0A7 


A9 


FD 




3369 


F0A9 


8D 


04 


03 


3370 


FOAC 


A9 


60 




3371 


FOAE 


8D 


00 


03 


3372 


FOBl 


A9 


00 




3373 


F0B3 


3D 


01 


03 


3374 


F0B6 


A9 


23 




3375 


F0B8 


8D 


06 


03 


3376 


FOBB 


AD 


02 


03 


3377 


FOBE 


AO 


40 




3378 


FOCO 


C9 


52 




3379 


F0C2 


FO 


02 




3380 


F0C4 


AO 


80 




3381 


F0C6 


8C 


03 


03 


3382 


F0C9 


A5 


3E 




3383 


FOCB 


8D 


OB 


03 


3384 


FOCE 


20 


59 


E4 


3385 


FODl 


60 






3386 










3387 










3388 










3389 


F0D2 


8D 


FF 


03 


3390 


F0D5 


A9 


55 




3391 


F0D7 


8D 


FD 


03 


3392 


FODA 


8D 


FE 


03 


3393 


FODD 


A9 


57 




3394 


FODF 


20 


95 


FO 


3395 


F0E2 


60 






3396 


F0E3 








3397 










3398 


0014 


00 
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SIOSB: ST A 


DCOMND 


LDA 


#0 


STA 


DBYTHI 


LDA 


#131 


STA 


DBYTLQ 


LDA 


#CBUFH 


STA 


DBUFHI 


LDA 


#CBUFL 


STA 


DBUFLO 


CSIO: LDA 


#*60 


STA 


DDEVIC 


LDA 


#0 


STA 


DUN IT 


LDA 


#35 


STA 


DTIMLO 


LDA 


DCOMND 


LDY 


#SRSTA 


CMP 


#'R 


BEQ 


»+4 


LDY 


#SWSTA 


STY 


DSTATS 


LDA 


FTYPE 


STA 


DAUX2 


JSR 


SIOV 


RTS 





; SAVE COMMAND 

; SET BUFFER LENGTH 

; SET BUFFER ADDRESS 
; CASSET PSEUDO DEVICE 

; DEVICE TIMEOUT <5/30/79) 

i GET COMMAND BACK 

; SIO READ STATUS COMMAND 



iSIO WRITE STATUS COMMAND 
i SET STATUS FOR SIO 

; INDICATE IF SHORT IRG MODE 
i GO CALL SIO 



WSIOSB 



WRITE SIO SYSTEM BUFFER 



WSIOSB: 


STA 


CASBUF+2 


; STORE TYPE BYTE 




LDA 


#*55 






STA 


CASBUF+0 






STA 


CASBUF-J-1 






LDA 


#'W /WRITE 






JSR 


SIOSB 


i CALL SIO ON SYSTEM BUFFER 




RTS 


AND 


; RETURN 


CRNTP6 


*=*14 






CASSPR: 


. BYTE 


M0N0R0-CRNTP6 i '^GCASCV IS TOO LONG 



ERR LINE ADDR Bl B2 B3 B4 



CASSET HANDLER 3/12 <DKi:CASCV> 
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3399 
3400 
3401 
3402 
3403 
3404 
3405 
3406 
3407 
3408 
3409 
3410 
3411 
3412 
3413 
3414 
3415 
3416 
3417 
3418 
3419 
3420 
3421 
3422 
3423 
3424 
3425 
3426 
3427 
3428 
3429 
3430 
3431 
3432 
3433 
3434 
3435 
3436 
3437 
3438 
3439 
3440 
3441 
3442 
3443 
3444 
3445 
3446 
3447 
3448 
3449 
3450 
3451 
3452 



TITLE 



'MONITOR ***** MONITP. SRC ***** 3/9/79 ***** 4:00:00 P 



0009 
0007 
OOOB 
0000 
0007 



0000 
007D 
0092 
0088 
0000 

0004 
0000 



BFFA 
BFFC 
BFFD 
BFFE 



CONSTANT EQUATES 



PUTTXT 


= 


$9 


OETCAR 


= 


%7 


PUTCAR 


= 


*B 


INIMLL 


= 


$00 


INIMLH 


= 


*07 


; GOOD 


= 


*1 


; WRITE 


= 


*57 


; READ 


= 


*52 


i STATC 


= 


*53 


SEX 


= 


$0 


CLS 


= 


*7D 


CTRLC 


= 


*92 


EOF 


= 


*88 


LIRG 


= 


*0 


BUFFH 


= 


(CA 


BUFFL 


= 


(-2 



"PUT TEXT RECORD" CIO COMMAND CODE 

"GET CHARACTER" CIO COMMAND CODE 

"PUT CHARACTER" CIO COMMAND CODE 

INITIAL MEM LO LOW BYTE 

INITIAL MEM LO HIGH BYTE 

GOOD STATUS CODE 

WRITE COMMAND 

READ COMMAND 

STATUS COMMAND 

SCREEN EDITOR lOCB INDEX 

CLEAR SCREEN CODE 

KEYBOARD CODE FOR 'CONTROL C ' 

CASSETTE END OF FILE CODE 

LONG IRG TYPE CODE 



(CASBUF+3)/256 

56)*BUFFH+CASBUF+3 i BUFFER POINTER 



THE FOLLOWING EQUATES ARE IN THE CARTRIDGE ADDRESS SPACE. 

"B" CARTRIDGE ADDR 'S ARE 8000-9FFF (36K CONFIG. ONLY) 
"A" CART. ADDR'S ARE AOOO-BFFF (36K CONFIG. ONLY) 

"A" CART. ADDR'S ARE BOOO-BFFF (48K CONFIG. ONLY) 



*=$BFFA 

CARTCS: . RES 2 

CART: .RES 1 

CARTFG: . RES 1 

CARTAD: . RES 2 



CARTRIDGE COLD START ADDRESS. 
CARTRIDGE AVAILABLE FLAG BYTE. 
CARTRIDGE FLAG BYTE. BIT 0=FLAG1, 
2-BYTE CARTRIDGE START VECTOR 



CARTRIDGE FLAG ACTION DEFINITIONS 



BIT 

7 

6-3 

2 

1 





ACTION IF SET 

SPECIAL — DON'T POWER-UP, JUST RUN CARTRIDGE 

NONE 

RUN CARTRIDGE 

NONE 

BOOT DOS 



LINE 


ADDR 


Bl 


B2 B3 B4 


3453 








3454 








3455 








3456 








3457 








3458 






i 


3459 






i 


3460 








3461 








3462 








3463 








3464 








3465 








3466 








3467 








3468 








3469 








3470 








3471 








3472 








3473 








3474 








3475 








3476 








3477 








3478 








3479 








3480 








3481 








3482 








3483 








3484 






1 


3485 


E471 


4C 


23 F2 


3486 






; 


3487 








3488 






; 


3489 


E474 


4C 


IB Fl 


3490 






i 


3491 








3492 






i 


3493 


E477 


4C 


25 Fl 


3494 






; 


3495 








3496 


9000 


20 


OC 90 


3497 


9003 


4C 


25 Fl 


3498 


9006 


20 


OC 90 


3499 


9009 


4G 


IB Fl 


3500 








3501 








3502 








3503 








3504 








3505 








3506 
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***** 

NOTE 

***** 

1. IF BIT2 IS O, GOTO BLACKBOARD MODE. 

2. IF BITO SET. THE DISK WILL BE BOOTED BEFORE ANY 
OTHER ACTION. 



PAGE 79 



POWER-UP VECTOR 

*****»*#»*******#****»**»*** 
*=*FFFC 

PVECT . WORD PWRUP 
************************* 



POWER-UP VECTOR 



ENTRY POINT VECTOR 

*=BLKBDV 

JMP SIGNON i BLACK BOARD VECTOR 

*=WARMSV 

JMP RESET ; WARM START VECTOR 

*=COLDSV 

JMP PWRUP ;COLD START VECTOR (9000 FOR RAM VECTOR WRIT 



*=*9000 
JSR *900C 
JMP PWRUP 
JSR *900C 
JMP RESET 



*=MONORG 



; (TO HANDLE RAM VECTOR WRITING) 



ERR LINE 


ADDR 


Bl 


B2 


B3 


B4 


3507 












3508 












3509 












3510 


F0E3 


50 








3511 


F0E4 


30 


E4 






3512 


F0E6 


43 








3513 


F0E7 


40 


E4 






3514 


F0E9 


45 








3515 


FOEA 


00 


E4 






3516 


FOEC 


53 








3517 


FOED 


10 


E4 






3518 


FOEF 


4B 








3519 


FOFO 


20 


E4 






3520 












3521 












3522 












3523 












3524 












3525 












3526 












3527 


F0F2 


7D 


41 


54 


41 


3528 


F0F6 


52 


49 


20 


43 


3529 


FOFA 


4F 


4D 


50 


55 


3530 


FOFE 


54 


45 


52 


20 


3531 


F102 


2D 


20 


4D 


45 


3532 


F106 


4D 


4F 


20 


50 


3533 


FlOA 


41 


44 


9B 




3534 












3535 


OOFO 










3536 


00F2 










3537 












3538 


OOOE 










3539 


FIOD 


42 


4F 


4F 


54 


3540 


Fill 


20 


45 


52 


52 


3541 


F115 


4F 


52 


9B 




3542 












3543 


OOFl 










3544 


OOOD 










3545 












3546 












3547 












3548 












3549 












3550 












3551 


F118 


45 


3A 


9B 




3552 












3553 


OOFl 










3554 


0018 










3555 


FllB 










3556 












3557 












3558 












3559 












3560 
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i HANDLER 


TABLE 1 


TBLENT: . BYTE 


'P' 


. WORD 


PRINTV 


. BYTE 


'C 


. WORD 


CASETV 


. BYTE 


'E' 


. WORD 


EDITRV 


. BYTE 


'S' 


. WORD 


SCRENV 


. BYTE 


'K' 


. WORD 


KEYBDV 



TBLLEN = IDENT-TBLENT-1 HANDLER TABLE LENGTH. 
*»#** PRINT MESSAGES ***** 

IDENT: .BYTE CLS, 'ATARI COMPUTER - MEMO PAD',CR 



"MOVED TO LINE 8 



IDENTH = 

IDENTL = 

i 

TBLLEN = 

DERR5: . BYTE 



DERRH 
DERRL 



I DENT/256 

( -256 )*IDENTH+ IDENT ; SYSTEM I.D. MSG POINTER 

IDENT-TBLENT-1 /HANDLER TABLE LENGTH 
'BOOT ERROR'. OR 



DERR5/256 

<-256)*DERRH+DERR5 ; DISK ERROR MSG POINTER 



DEVICE/FILENAME SPECIFICATIONS 

OPNEDT: .BYTE 'E: ',CR ; "OPEN SCREEN EDITOR" DEVICE SPEC. 

OPNH = aPNEDT/256 

OPNL =<-256)*QPNH+0PNEDT ; SCREEN EDITOR OPEN POINTER 



»*«»*****»*»**#»*»**•»*»*»*#**»»#**♦»»*#»»*»•«•##*#*»»*»»***»»»»#•»*» 



LINE 


ADDR 


Bl 


B2 


B3 


3561 










3562 










3563 










3564 


FllB 


78 






3565 


Flic 


AD 


44 


02 


3566 


Flip 


DO 


04 




3567 


F121 


A9 


FF 




3568 


F123 


DO 


03 




3569 










3570 










3571 










3572 










3573 










3574 










3575 










3576 


F125 


78 






3577 


F126 


A9 


00 




3578 


F128 


85 


08 




3579 


F12A 


D8 






3580 


F12B 


A2 


FF 




3581 


F12D 


9A 






3582 


F12E 


20 


3F 


F2 


3583 


F131 


20 


77 


F2 


3584 


F134 


A5 


08 




3585 


F136 


DO 


28 




3586 










3587 


F138 


A9 


00 




3588 


F13A 


AO 


08 




3589 


F13C 


85 


04 




3590 


F13E 


85 


05 




3591 


F140 


91 


04 




3592 


F142 


C8 






3593 


F143 


CO 


00 




3594 


F145 


DO 


F9 




3595 


F147 


E6 


05 




3596 


F149 


A6 


05 




3597 


F14B 


E4 


06 




3598 


F14D 


DO 


Fl 




3599 










3600 










3601 


F14F 


AD 


72 


E4 


3602 


F152 


85 


OA 




3603 


F154 


AD 


73 


E4 


3604 


F157 


85 


OB 




3605 


F159 


A9 


FF 




3606 


F15B 


8D 


44 


02 


3607 


F15E 


DO 


13 




3608 










3609 










3610 


F160 


A2 


00 




3611 


F162 


8A 






3612 


F163 


9D 


00 


02 


3613 


F166 


9D 


OO 


03 


3614 


F169 


CA 
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RESET BUTTON ROUTINE STARTS HERE 



RESET: 



SEI 
LDA 
BNE 
LDA 
BNE 



COLDST 
PWRUP 
#*FF 
PWRUP 1 



DISABLE IRQ INTERRUPTS 

WERE WE IN MIDDLE OF COLDSTART? 

YES, GO TRY IT AGAIN 

; SET WARM START FLAG 



POWER UP ROUTINES START HERE 



PWRUP: SEI 
LDA 

PWRUP 1: STA 
CLD 
LDX 
TXS 
JSR 
JSR 
LDA 
BNE 

ZERORM: LDA 
LDY 
STA 
STA 

CLRRAM: STA 
I NY 
CRY 
BNE 
INC 
LDX 
CPX 
BNE 



#0 
WARMST 

#*FF 

SPECL 
HARD I 
WARMST 
ZOSRAM 

#0 

ttWARMST 
RAMLO 
RAMLO+1 
(RAMLO), Y 

#0 

CLRRAM 

RAMLO+1 

RAMLO+1 

TRAMS Z 

CLRRAM 



; DISABLE IRQ INTERRUPTS 
; CLEAR WARMSTART FLAG 

i CLEAR DECIMAL FLAG. 

SET STACK POINTER 
CARTRIDGE SPECIAL CASE? 
DO HARDWARE INITIALIZATION 
IS IT WARMSTART? 
YES, ONLY ZERO OS RAM 



; INITIALIZE RAM POINTER 
i CLEAR MEMORY LOC. 

i AT END OF PAGE? 

; YES, INCR PAGE POINTER 

,• AT END OF MEM? 
; NO. 



INITIALIZE DOSVEC TO POINT TO SIGNON (BLACKBOARD) 



LDA 
STA 
LDA 
STA 
LDA 
STA 
BNE 



BLKBDV+1 

DOSVEC 

BLKBDV+2 

DOSVEC +1 

#*FF 

COLDST 

ESTSCM 



; USE BLACKBOARD VECTOR 
; FOR DOSVEC 



;SET TO SHOW IN MIDDLE OF COLDSTART 
! GO AROUND ZOSRAM 



; CLEAR OS RAM (FOR WARMSTART) 

ZOSRAM: LDX #0 

TXA 

Z0SRM2: STA *200, X ; CLEAR PAGES 2 AND 3 

STA *300, X 

DEX 



ERR LINE ADDR Bl B2 B3 B4 
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3615 


F16A 


DO 


F7 




3616 


F16C 


A2 


10 




3617 


F16E 


95 


00 




3618 


F170 


E8 






3619 


F171 


10 


FB 




3620 










3621 










3622 


F173 


A9 


02 




3623 


F175 


85 


52 




3624 


F177 


A9 


27 




3625 


F179 


85 


53 




3626 










3627 










3628 










3629 


F17B 


A2 


25 




3630 


F17D 


BD 


80 


E4 


3631 


F180 


9D 


00 


02 


3632 


F183 


CA 






3633 


F1S4 


10 


F7 




3634 


F186 


20 


8A 


F2 


3635 


F189 


58 






3636 










3637 










3638 










3639 










3640 


F18A 


A2 


OE 




3641 


F18C 


BD 


E3 


FO 


3642 


F18F 


9D 


lA 


03 


3643 


F192 


CA 






3644 


F193 


10 


F7 




3645 










3646 










3647 










3648 










3649 










3650 










3651 










3652 


F195 


A2 


00 




3653 


F197 


86 


07 




3654 


F199 


86 


06 




3655 


F19B 


AE 


E4 


02 


3656 


F19E 


EO 


90 




3657 


FIAO 


BO 


OA 




3658 


F1A2 


AD 


FC 


9F 


3659 


F1A5 


DO 


05 




3660 


F1A7 


E6 


07 




3661 


F1A9 


20 


3C 


F2 


3662 










3663 


FIAC 


AE 


E4 


02 


3664 


FIAF 


EO 


BO 




3665 


FlBl 


BO 


OA 




3666 


F1B3 


AE 


FC 


BF 


3667 


F1B6 


DO 


05 




3668 


F1B8 


E6 


06 







BNE 


Z0SRM2 




LDX 


#INTZBS 


Z0SRM3: 


STA 
INX 


0, X 




BPL 


Z0SRM3 



i CLEAR ZERO PAGE LOCATIONS INTZBS-7F 



i ESTABLISH SCREEN MARGINS 

ESTSCM: LDA #LEDGE 

STA LMARGN 

LDA #REDGE 

STA RMARON 



; MOVE 


VECTOR 


TABLE FROM 


ROM TO RAM 


OPSYS: 


LDX 


#*25 




MO WEC : 


LDA 


VCTABL, X 


i ROM TABLE 




STA 


INTABS, X 


; TO RAM 




DEX 








BPL 


MOVVEC 






JSR 


OSRAM 


i DO 0. S. R 




CLI 




.ENABLE IR 



RAM SETUP 



LINK HANDLERS 





LDX 


#TBLLEN 


NXTENT: 


LDA 


TBLENT, X 




STA 


HATABS, X 




DEX 






BPL 


NXTENT 



i READ HANDLER TABLE ENTRY 
; PUT IN TABLE 

; DONE WITH ALL ENTRIES? 



INTERROGATE CARTRIDGE ADDR. SPACE TO SEE WHICH CARTRIDGES THERE ARE 



ENDBCK: 



LDX 
STX 
STX 
LDX 
CPX 
BCS 
LDA 
BNE 
INC 
JSR 

LDX 
CPX 
BCS 
LDX 
BNE 
INC 



#0 

TSTDAT 

TRAMSZ 

RAMS I Z 

#*90 

ENDBCK 

CART-*2000 

ENDBCK 

TSTDAT 

CBINI 

RAMSIZ 

#*B0 

ENDACK 

CART 

ENDACK 

TRAMSZ 



i CLEAR "B" CART. 
; CLEAR "A" CART. 



FLAG 
FLAG 



; RAM IN "B" CART. SLOT? 

NO, 

CART. PLUGGED INTO "B" SLOT? 
YES, SET "B" CART. FLAG 
INITIALIZE CARTRIDGE "B" 



; RAM IN "A" CART. SLOT? 

NO, 

CART. PLUGGED INTO "A" SLOT? 

YES, SET "A" CART. FLAG 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


3669 


FIBA 


20 


39 


F2 


3670 










3671 










3672 










3673 










3674 


FIBD 


A9 


03 




3675 


FIBF 


A2 


00 




3676 


FlCl 


9D 


42 


03 


3677 


F1C4 


A9 


18 




3678 


F1C6 


9D 


44 


03 


3679 


F1C9 


A9 


Fl 




3680 


FICB 


9D 


45 


03 


3681 


FICE 


A9 


OC 




3682 


FIDO 


9D 


4A 


03 


3683 


F1D3 


20 


56 


E4 


3684 










3685 


F1D6 


10 


03 




3686 


F1D8 


4C 


25 


Fl 


3687 


FIDB 


E8 






3688 


FIDC 


DO 


FD 




3689 


FIDE 


C8 






3690 


FIDF 


10 


FA 




3691 










3692 










3693 










3694 


FlEl 


20 


B2 


F3 


3695 










3696 










3697 


F1E4 


A5 


06 




3698 


F1E6 


05 


07 




3699 


F1E8 


FO 


12 




3700 


FlEA 


A5 


06 




3701 


FlEC 


FO 


03 




3702 


FIEE 


AD 


FD 


BF 


3703 


FlFl 


A6 


07 




3704 


F1F3 


FO 


03 




3705 


F1F5 


OD 


FD 


9F 


3706 


F1F8 


29 


01 




3707 


FIFA 


FO 


03 




3708 










3709 










3710 


FIFC 


20 


CF 


F2 


3711 










3712 










3713 


FIFF 


A9 


00 




3714 


F201 


8D 


44 


02 


3715 


F204 


A5 


06 




3716 


F206 


FO 


OA 




3717 


F208 


AD 


FD 


BF 


3718 


F20B 


29 


04 




3719 


F20D 


FO 


03 




3720 


F20F 


6C 


FA 


BF 


3721 


F212 


A5 


07 




3722 


F214 


FO 


OA 
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JSR CAINI ; INITIALIZE CARTRIDGE "A" 

OPEN SCREEN EDITOR 
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ENDACK: LDA 
LDX 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
JSR 

i 

BPL 
JMP 
SCRNOK: INX 
BNE 
I NY 
BPL 



#3 
#SEX 
ICCOM. X 
»OPNL 
ICBAL. X 
#OPNH 
ICBAH, X 
#*C 

ICAXl/ X 
CIOV 

SCRNOK 
PWRUP 

SCRNOK 

SCRNOK 



DO CASSETTE BOOT 

JSR CSBOOT 



{OPEN I/O COMMAND 



;SET BUFFER POINTER TO OPEN SCREEN EDITOR 

iSET UP OPEN FOR INPUT/OUTPUT 
i 00 TO CIO 

BR IF NO ERROR 

RETRY PWRUP IF ERROR (SHOULD NEVER HAPPEN!) 

SCREEN OK, SO WAIT FOR VBLANK TO 

BRING UP THE DISPLAY 



J CHECK, BOOT, AND INIT 



; CHECK TO SEE 
LDA 
ORA 
BEQ 
LDA 
BEQ 
LDA 

NOAl: LDX 
BEQ 
ORA 

NOBl: AND 
BEQ 



IF EITHER CARTRIDGE WANTS DISK BOOT 



TRAMS Z 

TSTDAT 

NOCART 

TRAMS Z 

NOAl 

CARTFO 

TSTDAT 

NOBl 

CARTF0-*2000 

#1 

NOBOOT 



; DO DISK BOOT 
NOCART: JSR BOOT 



CHECK BOTH CARTRIDGES 

NEITHER CARTRIDGE LIVES 

"A" CART? 

NO 

GET CARTRIDGE MODE FLAG 

"B" CART? 

NO 

; ADD OTHER FLAG 

DOES EITHER CART WANT BOOT? 

NO 



CHECK, BOOT, AND INIT 



; GO TO ONE OF THE CARTRIDGES IF THEY SO DESIRE 



NOBOOT: 


LDA 


#0 






STA 


COLDST 


RESET TO SHOW DONE WITH COLDSTART 




LDA 


TRAMSZ 


"A" CART? 




BEQ 


N0A2 


NO 




LDA 


CARTFG 


GET CARTRIDGE MODE FLAG 




AND 


#4 


DOES IT WANT TO RUN? 




BEQ 


N0A2 


NO 




JMP 


(CARTCS) 


RUN "A" CARTRIDGE 


N0A2: 


LDA 


TSTDAT 


"B" CART? 




BEQ 


N0CAR2 


NO 



ERR LINE 


ADDR 


Bi 


B2 


B3 B4 


3723 


F216 


AD 


FD 


9F 


3724 


F219 


29 


04 




3725 


F21B 


FO 


DF 




3726 


F21D 


6C 


FA 


9F 


3727 










3728 










3729 










3730 


F220 


6C 


OA 


00 


3731 










3732 










3733 


F223 


A2 


F2 




3734 


F225 


AO 


FO 




3735 


F227 


20 


85 


F3 


3736 










3737 










3738 










3739 










3740 


F22A 


20 


30 


F2 


3741 


F22D 


4C 


2A 


F2 


^ 3742 


F230 


AD 


05 


E4 


^ 3743 


F233 


48 






3744 


F234 


AD 


04 


E4 


3745 


F237 


48 






3746 


F238 


60 






3747 










3748 










3749 










3750 


F239 


6C 


FE 


BF 


3751 


F23C 


6C 


FE 


9F 



MONITOR *»**♦ MONITP. SRC ***** 3/9/79 ***** 4:00 

LDA CARTFG-*2000 ; GET "B" MODE FLAG 

AND #4 ;DOES IT WANT TO RUN? 

BEQ NOCART ; NO 

JMP (CARTCS-*2000> ; RUN "B" CARTRIDGE 

NO CARTRIDGES, OR NEITHER WANTS TO RUN, 
SO GO TO DOSVEC (DOS, CASSETTE, OR BLACKBOARD) 
N0CAR2: JMP (DOSVEC) 

; PRINT SIGN-ON MESSAGE 
SIGNON: LDX #IDENTL 

LDY #IDENTH 

JSR PUTLIN ; GO PUT SIGN-ON MSG ON SCREEN 



PAGE 



84 



BLACKBOARD ROUTINE 
BLACKB: JSR BLKB2 

JMP BLACKB 
BLKB2: LDA EDITRV+5 

PHA 

LDA EDITRV+4 

PHA 

RTS 



; "JSR EGETCH" 
; FOREVER 
; HIGH BYTE 

; LOW BYTE 

; SIMULATES "JMP (EDITRV) 



CARTRIDGE INITIALIZATION INDIRECT JUMPS 
CAINI: JMP (CARTAD) 
CBINI: JMP (CARTAD-*2000) 



ERR LINE 


ADDR 


Bl 


B2 


B3 


3752 










3753 










3754 










3755 










3756 










3757 










3758 










3759 










3760 










3761 










3762 










3763 










3764 










3765 










3766 










3767 










3768 










3769 










3770 










3771 










3772 










3773 










3774 










3775 










3776 










3777 










3778 










3779 










3780 










3781 


F23F 


AD 


FC 


BF 


3782 


F242 


DO 


13 




3783 


F244 


EE 


FC 


BF 


3784 


F247 


AD 


FC 


BF 


3785 


F24A 


DO 


08 




3786 


F24C 


AD 


FD 


BF 


3787 


F24F 


10 


03 




3788 


F251 


6C 


FE 


BF 


3789 










3790 










3791 










3792 










3793 


F254 


CE 


FC 


BF 


3794 


F257 


AO 


00 




3795 


F259 


84 


05 




3796 


F25B 


A9 


10 




3797 


F25D 


85 


06 




3798 


F25F 


Bl 


05 




3799 


F261 


49 


FF 




3800 


F263 


91 


05 




3801 


F265 


Dl 


05 




3802 


F267 


DO 


OD 




3803 


F269 


49 


FF 




3804 


F26B 


91 


05 




3805 


F26D 


A5 


06 





MONITOR ***** MONITP. SRC ***** 3/9/79 ***** 4:00 
. PAGE 



PAGE 85 



SUBROUT INES 



CHECK FOR HOW MUCH RAM 9^. SPECIAL CARTRIDGE CASE. 

IF SPECIAL CARTRIDGE CASE, DON'T GO BACK — GO TO CART. 



SPECL: 



LDA 


CART 


BNE 


ENSPE2 


INC 


CART 


LDA 


CART 


BNE 


ENSPEC 


LDA 


CARTFG 


BPL 


ENSPEC 


JMP 


<CARTAD> 



CHECK FOR AMOUNT OF RAM 



ENSPEC : 


DEC 


CART 




ENSPE2: 


LDY 


#0 






STY 


RAMLO+1 






LDA 


#*10 






STA 


TRAMS Z 




HOWMCH: 


LDA 


< RAMLO+1) 


Y 




EOR 


#*FF 






STA 


(RAMLO+1), 


Y 




CMP 


(RAMLO+1), 


Y 




BNE 


ENDRAM 






EOR 


#*FF 






STA 


(RAMLO+1), 


Y 




LDA 


TRAMSZ 





CHECK FOR RAM OR CART 

GO IF NOTHING OR MAYBE RAM 

NOW DO RAM CHECK 

IS IT ROM? 

NO 

YES, 

BIT SET? 

YES. GO RUN CARTRIDGE 



; RESTORE RAM IF NEEDED 



; SET RAM POINTER TO 4K. 

.READ RAM LOCATION 

i INVERT IT. 

; WRITE INVERTED DATA. 

iREAD RAM AGAIN 

{CONVERT IT BACK 

{RESTORE ORIGINAL RAM DATA 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


3806 


F26F 


18 






3807 


F270 


69 


10 




3808 


F272 


85 


06 




3809 


F274 


DO 


E9 




3810 


F276 


60 






3811 










3812 










3813 










3814 










3815 










3816 










3817 










3818 


F277 


A9 


00 




3819 


F279 


AA 






3820 


F27A 


9D 


00 


DO 


3821 


F27D 


9D 


00 


D4 


3822 


F280 


9D 


00 


D2 


3823 


F283 


9D 


00 


D3 


3824 


F286 


E8 






3825 


F287 


DO 


Fl 




3826 


F289 


60 






3827 










3828 










3829 










3830 










3831 


F28A 


C6 


11 




3832 


F28C 


A9 


54 




3833 


F28E 


8D 


36 


02 


3834 


F291 


A9 


E7 




3835 


F293 


8D 


37 


02 


3836 


F296 


A5 


06 




3837 


F298 


8D 


E4 


02 


3838 


F29B 


8D 


E6 


02 


3839 


F29E 


A9 


00 




3840 


F2A0 


8D 


E5 


02 


3841 


F2A3 


A9 


00 




3842 


F2A5 


8D 


E7 


02 


3843 


F2A8 


A9 


07 




3844 


F2AA 


8D 


E8 


02 


3845 


F2AD 


20 


OC 


E4 


3846 


F2B0 


20 


IC 


E4 


3847 


F2B3 


20 


2C 


E4 


3848 


F2B6 


20 


3C 


E4 


3849 


F2B9 


20 


4C 


E4 


3850 


F2BC 


20 


6E 


E4 


3851 


F2BF 


20 


65 


E4 


3852 


F2C2 


20 


6B 


E4 


3853 


F2C5 


AD 


IF 


DO 


3854 


F2C8 


29 


01 




3855 


F2CA 


DO 


02 




3856 


F2CC 


E6 


4A 




3857 


F2CE 


60 






3858 










3859 











MONITOR »»*** 


MONITP 


CLC 




ADC 


#*10 


STA 


TRAMSZ 


BNE 


HOWMCH 


ENDRAM: RTS 





4:00 



} INCR. RAM POINTER BY 4K. 
;00 FIND HOW MUCH RAM. 
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HARDWARE INITIALIZATION 



HARD I: LDA 


#0 




TAX 






CLRCHP: STA 


*D000. X 




STA 


*D400, X 




STA 


*D200. X 




STA 


*D300, X 




INX 






BNE 


CLRCHP 




RTS 






; 0. S. 


RAM SETUP 




OSRAM: DEC 


BRKKEY 


; TURN OFF BREAK KEY FLAG 


LDA 


#. LOW. BRKKY2 




STA 


BRKKY 




LDA 


#. HIGH. BRKKY2 


STA 


BRKKY+1 




LDA 


TRAMSZ 


READ RAM SIZE IN TEMP. REG. 


STA 


RAMSIZ 


SAVE IT IN RAM SIZE. 


STA 


MEMTOP+1 


INIT. MEMTOP ADDR HI BYTE 


LDA 


#0 




STA 


MEMTOP 


INIT. MEMTOP ADDR LO BYTE 


LDA 


#INIMLL 




STA 


MEMLO 




LDA 


#INIMLH 




STA 


MEMLO+1 


INITIALIZE MEMLO ADDR VECTOR 


JSR 


EDITRV+*C 


EDITOR INIT. 


JSR 


SCRENV+*C 


SCREEN INIT. 


JSR 


KEYBDV+*C 


KEYBOARD INIT. 


JSR 


PRINTV+*C 


PRINTER HANDLER INIT 


JSR 


CASETV-»-*C 


CASSETTE HANDLER INIT 


JSR 


CIOINV 


CIO INIT. 


JSR 


SIOINV 


SIO INIT. 


JSR 


INTINV 


INTERRUPT HANDLER INIT. 


LDA 


CONSOL 




AND 


#*1 




BNE 


NOKEY 


GAME START KEY DEPRESSED? 


INC 


CKEY 


YES, SET KEY FLAG. 


NOKEY: RTS 







ERR LINE 


ADDR 


Bl 


B2 


B3 


3860 










3861 










3862 


F2CF 


A5 


08 




3863 


F2D1 


FO 


OA 




3864 


F2D3 


A5 


09 




3865 


F2D5 


29 


01 




3866 


F2D7 


FO 


03 




3867 


F2D9 


20 


7E 


F3 


3868 


F2DC 


60 






3869 


F2DD 


A9 


01 




3870 


F2DF 


8D 


01 


03 


3871 


F2E2 


A9 


53 




3872 


F2E4 


8D 


02 


03 


3873 


F2E7 


20 


53 


E4 


3874 


F2EA 


10 


01 




3875 


F2EC 


60 






3876 










3877 


F2ED 


A9 


00 




3878 


F2EF 


8D 


OB 


03 


3879 


F2F2 


A9 


01 




3880 


F2F4 


8D 


OA 


03 


3881 


F2F7 


A9 


00 




3882 


F2F9 


8D 


04 


03 


3883 


F2FC 


A9 


04 




3884 


F2FE 


8D 


05 


03 


3885 


F301 


20 


9D 


F3 


3886 


F304 


10 


08 




3887 


F306 


20 


81 


F3 


3888 


F309 


A5 


4B 




3889 


F30B 


FO 


EO 




3890 


F30D 


60 






3891 


F30E 


A2 


03 




3892 


F310 


BD 


00 


04 


3893 


F313 


9D 


40 


02 


3894 


F316 


CA 






3895 


F317 


10 


F7 




3896 


F319 


AD 


42 


02 


3897 


F31C 


85 


04 




3898 


F31E 


AD 


43 


02 


3899 


F321 


85 


05 




3900 


F323 


AD 


04 


04 


3901 


F326 


85 


OC 




3902 


F328 


AD 


05 


04 


3903 


F32B 


85 


OD 




3904 


F32D 


AO 


7F 




3905 


F32F 


B9 


00 


04 


3906 


F332 


91 


04 




3907 


F334 


88 






3908 


F335 


10 


F8 




3909 


F337 


18 






3910 


F338 


A5 


04 




3911 


F33A 


69 


80 




3912 


F33C 


85 


04 




3913 


F33E 


A5 


05 
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i DO BOOT OF DISK 



BOOT: LDA 
BEQ 
LDA 
AND 
BEQ 
JSR 
NOINIT: RTS 
NOWARM: LDA 
STA 
LDA 
STA 
JSR 
BPL 
RTS 



DOBOOT: 



SECTl: 
BADDSK: 



ALLSEC : 
RDBYTE: 



MVBUFF: 
MVNXB: 



LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
JSR 
BPL 
JSR 
LDA 
BEQ 
RTS 
LDX 
LDA 
STA 
DEX 
BPL 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDY 
LDA 
STA 
DEY 
BPL 
CLC 
LDA 
ADC 
STA 
LDA 



WARMST 

NOWARM 

BOOT? 

#1 

NOINIT 

DINI 

#1 

DUN IT 

«STATC 

DCOMND 

DSKINV 

DOBOOT 



#0 

DAUX2 

#1 

DAUXl 

#BUFFL 

DBUFLO 

#BUFFH 

DBUFHI 

GETSEC 

ALLSEC 

DSKRDE 

CASSBT 

DOBOOT 

#3 

CASBUF+3, X 
DFLAGS. X 

RDBYTE 

BOOTAD 

RAMLO 

BOOTAD+1 

RAMLO+1 

CASBUF+7 

DOSINI 

CASBUF+8 

DOSINI+1 

#*7F 

CASBUF+3, Y 

(RAMLO)/ Y 

MVNXB 

RAMLO 
#*80 
RAMLO 
RAMLO+l 



iWARM START? 
; YESi 

; VALID BOOT? 

jYES, RE-INIT. DOS SOFTWARE 



/ASSIGN DISK DRIVE NO. 

SET UP STATUS COMMAND 

GO DO DISK STATUS 

IS STATUS FROM SIO GOOD? 

NO, GO BACK WITH BAD BOOT STATUS 



/SET SECTOR # TO 1. 



SET UP BUFFER ADDR 

GET SECTOR 

STATUS 0. K. ? 

NO, GO PRINT DISK READ ERROR 

; CASSETTE BOOT? 
; YES, QUIT 

i READ A BUFFER BYTE 
; STORE IT 

; DONE WITH 4 BYTE TRANSFER ? 
; YES, 



/•PUT BOOT ADDR INTO Z. PAGE RAM 
/ESTABLISH DOS INIT ADDRESS 

; YES, SET BYTE COUNT 

/ MOVE A BYTE FROM SECTOR BUFFER TO BOOT ADDR 

; DONE ? 
i YES, 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


3914 


F340 


69 


00 




3915 


F342 


85 


05 




3916 


F344 


CE 


41 


02 


3917 


F347 


FO 


11 




3918 


F349 


EE 


OA 


03 


3919 


F34C 


20 


9D 


F3 


3920 


F34F 


10 


DC 




3921 


F351 


20 


81 


F3 


3922 


F354 


A5 


4B 




3923 


F356 


DO 


AE 




3924 


F358 


FO 


F2 




3925 


F35A 


A5 


4B 




3926 


F35C 


FO 


03 




3927 


F35E 


20 


9D 


F3 


3928 


F361 


20 


6C 


F3 


3929 


F364 


BO 


AO 




3930 


F366 


20 


7E 


F3 


3931 


F369 


E6 


09 




3932 


F36B 


60 






3933 


F36C 


18 






3934 


F36D 


AD 


42 


02 


3935 


F370 


69 


06 




3936 


F372 


85 


04 




3937 


F374 


AD 


43 


02 


3938 


F377 


69 


00 




3939 


F379 


85 


05 




3940 


F37B 


6C 


04 


00 


3941 


F37E 


6C 


OC 


00 


3942 










3943 










3944 










3945 










3946 










3947 










3948 


F381 


A2 


OD 




3949 


F383 


AO 


Fl 




3950 










3951 










3952 










3953 










3954 










3955 










3956 










3957 










3958 


F385 


8A 






3959 


F386 


A2 


00 




3960 


F388 


9D 


44 


03 


3961 


F38B 


98 






3962 


F38C 


9D 


45 


03 


3963 


F38F 


A9 


09 




3964 


F391 


9D 


42 


03 


3965 


F394 


A9 


FF 




3966 


F396 


9D 


48 


03 


3967 


F399 


20 


56 


E4 
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ADC 


#0 




STA 


RAMLO+1 ; 




DEC 


DBSECT ; 




BEQ 


ENBOOT ; 




INC 


DAUXl ; 


SECTX: 


JSR 


GETSEC ; 




BPL 


MVBUFF ; 




JSR 


DSKRDE ; 




LDA 


CASSBT 




BNE 


BADDSK ; 




BEQ 


SECTX ; 


ENBOOT: 


LDA 


CASSBT 




BEQ 


XBOOT i 




JSR 


GETSEC i 


XBOOT: 


JSR 


BLOAD ; 




BCS 


BADDSK / 




JSR 


DINI ; 




INC 


BOOT? i 




RTS 




BLOAD: 


CLC 






LDA 


BOOTAD 




ADC 


#6 




STA 


RAMLO 




LDA 


BOOTAD+1 




ADC 


#0 




STA 


RAMLO+1 




JMP 


< RAMLO > 


DINI: 


JMP 


CDOSINI) 



INCR BOOT LOADER BUFFER POINTER. 

DECR # OF SECTORS. 

MORE SECTORS ? 

YES, INCR SECTOR # 

GO GET SECTOR. 

STATUS O. K. ? 

NO, GO PRINT DISK READ ERROR 

IF CASSETTE. QUIT. 

IF DISK, TRY SECTOR AGAIN. 

CASSETTE BOOT ? 

YES, GET EOF RECORD, BUT DON'T USE 

GO EXECUTE BOOT LOADER 

IF BAD BOOT, DO IT OVER AGAIN 

GO INIT. SOFTWARE 

SHOW BOOT SUCCESS 



IT. 



} PUT START ADDR OF BOOTLOADER INTO RAM 



DISPLAY DISK READ ERROR MSG 



DSKRDE: LDX 
LDY 



#DERRL 
#DERRH 



PUT LINE ON SCREEN AT PRESENT CURSOR POSITION 

X-REG -- LO BYTE, BEGIN ADDR OF LINE 
Y-REO — HI BYTE, BEGIN ADDR OF LINE 



PUTLIN: TXA 




LDX 


#SEX 


STA 


ICBAL, X 


TYA 




STA 


ICBAH, X 


LDA 


#PUTTXT 


STA 


ICCOM, X 


LDA 


#*FF 


STA 


ICBLL, X 


JSR 


CIOV 



i SET UP ADDR OF BEGIN OF LINE 

; "PUT TEXT RECORD" COMMAND 

; SET BUFFER LENGTH 
jPUT line on SCREEN 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


3968 


F39C 


60 






3969 










3970 










3971 










3972 










3973 










3974 










3975 


F39D 


A5 


4B 




3976 


F39F 


FO 


03 




3977 


F3A1 


4C 


7A 


E4 


3978 


F3A4 


A9 


52 




3979 


F3A6 


8D 


02 


03 


3980 


F3A9 


A9 


01 




3981 


F3AB 


QD 


01 


03 


3982 


F3AE 


20 


53 


E4 


3983 


F3B1 


60 






3984 










3985 










3986 










3987 










3988 










3989 


F3B2 


A5 


08 




3990 


F3B4 


FO 


OA 




3991 


F3B6 


A5 


09 




3992 


F3B8 


29 


02 




3993 


F3BA 


FO 


03 




3994 


F3BC 


20 


El 


F3 


3995 


F3BF 


60 






3996 










3997 


F3C0 


A5 


4A 




3998 


F3C2 


FO 


IC 




3999 


F3C4 


A9 


80 




4000 


F3C6 


85 


3E 




4001 


F3C8 


E6 


4B 




4002 


F3CA 


20 


7D 


E4 


4003 


F3CD 


20 


01 


F3 


4004 


F3D0 


A9 


00 




4005 


F3D2 


85 


4B 




4006 


F3D4 


85 


4A 




4007 


F3D6 


06 


09 




4008 


F3D8 


AS 


OC 




4009 


F3DA 


85 


02 




4010 


F3DC 


A5 


OD 




4011 


F3DE 


85 


03 




4012 


F3E0 


60 






4013 










4014 


F3E1 


6C 


02 


00 


4015 










4016 










4017 










4018 










4019 










4020 


F3E4 








4021 
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RTS 

GET SECTOR FROM DISK 



; CASSETTE BOOT ? 

; YES, GO TO READ BLOCK ROUTINE 

; SET READ SECTOR COMMAND 

iSET DRIVE NO. TO DRIVE 
i GET SECTOR 



GETSEC : LDA 


CASSBT 


BEQ 


DISKM 


JMP 


RBLOKV 


DISKM: LDA 


#READ 


STA 


DCOMND 


LDA 


#1 


STA 


DUN IT 


JSR 


DSKINV 


RTS 





DO CHECK FOR CASSETTE BOOT & IF SO, DO BOOT 



WARMSTART? 

NO 

GET BOOT FLAG 

WAS CASSETTE BOOT SUCCESFULL' 

NO 

YES, INIT CASSETTE SOFTWARE 



"C" KEY FLAG SET ? 

YES, 

SET LONG IRG TYPE 

SET CASSETTE BOOT FLAG 

OPEN CASSETTE FOR INPUT 

DO BOOT ?< INIT. 

RESET CASSETTE BOOT FLAG 

CLEAR KEY FLAG 

SHIFT BOOT FLAG <N0W=2 IF SUCCESS) 

; MOVE INIT ADDRESS FOR CASSETTE 



CINI: JMP (CASINI) ; INIT CASSETTE 
***»»******»*♦»**»***»*»***»*#***»»»#*#**»***»**»*#**»**#*#*»#*»#»»»»** 



CSBOOT: 


LDA 


WARMST i 




BEQ 


CSB0T2 i 




LDA 


BOOT? 




AND 


#2 




BEQ 


N0CSB2 ; 




JSR 


CINI i 


N0CSB2: 


RTS 




i 

CSB0T2: 


LDA 


CKEY 




BEQ 


NOCSBT 




LDA 


#*80 i 




STA 


FTYPE i 




INC 


CASSBT ; 




JSR 


CSOPIV i 




JSR 


SECTl ; 




LDA 


#0 




STA 


CASSBT i 




STA 


CKEY i 




ASL 


BOOT? i 




LDA 


DOSINI 




STA 


CASINI ; 




LDA 


DOSINI+1 




STA 


CASINI+1 


NOCSBT: 


RTS 





SPARE BYTE OR MODULE TOO LONG FLAG 
CRNTP7 =» 



ERR LINE ADDR Bl B2 B3 B4 MONITOR »»**» MONITP. SRC »*»»* 3/9/79 *»*** 4:00 PAGE 90 

4022 »=*14 

4023 0014 00 MONSPR: .BYTE KBD0R0-CRNTP7 ; ^GMONITP TOO LONG 
4024 



ERR LINE ADDR Bl B2 B3 B4 
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4025 
4026 
4027 
4028 
4029 
4030 
4031 
4032 
4033 
4034 
4035 



007D 
009F 

0068 
0066 



PAGE 

TITLE 'DISPLAY HANDLER — 10-30-78 — DISPLC 



HANDLER DEPENDENT EQUATES 



CLRCOD = 
CNTLl 

i 

FRMADR = 
TOADR 



*7D 
*9F 

SAVADR 
MLTTMP 



J CLEAR SCREEN AT ASCI CODE 
; POKEY KEY CODE FOR -^1 



ERR LINE 


ADDR 


Bl 


B2 B3 


4036 








4037 








4038 








4039 








4040 








4041 








4042 








4043 


E400 


FB 


F3 


4044 


E402 


33 


F6 


4045 


E404 


3D 


F6 


4046 


E406 


A3 


F6 


4047 


E408 


33 


F6 


4048 


E40A 


3C 


F6 


4049 


E40C 


4C 


E4 F3 


4050 


E40F 


00 




4051 








4052 








4053 








4054 








4055 








4056 


E410 


F5 


F3 


4057 


E412 


33 


F6 


4058 


E414 


92 


F5 


4059 


E416 


B6 


F5 


4060 


E418 


33 


F6 


4061 


E41A 


FB 


FC 


4062 


E41C 


4C 


E4 F3 


4063 


E41F 


00 




4064 








4065 








4066 








4067 








4068 








4069 








4070 


E420 


33 


F6 


4071 


E422 


33 


F6 


4072 


E424 


El 


F6 


4073 


E426 


3C 


F6 


4074 


E428 


33 


F6 


4075 


E42A 


3C 


F6 


4076 


E42C 


4C 


E4 F3 


4077 


E42F 


00 




4078 








4079 








4080 








4081 








4082 


E488 


BE 


FF 
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. PAGE 

»=EDITRV 



< CLOSE) 



PAGE 92 



i 

i SCREEN EDITOR 


HANDLER 


» 

EDITOR: .WORD 


EOPEN-1 


.WORD 


RETURl-1 


. WORD 


EGETCH-1 


. WORD 


EOUTCH-1 


. WORD 


RETURl-1 


. WORD 


NOFUNC-1 


JMP 


PWRONA 


. BYTE 






(STATUS) 
(SPECIAL) 

ROM FILLER BYTE 



*=SCRENV 



; DISPLAY HANDLER ENTRY 


DISPLA: . WORD 


DOPEN-1 


. WORD 


RETURl-1 


. WORD 


GETCH-1 


. WORD 


OUTCH-1 


. WORD 


RETURl-1 


. WORD 


DRAW-1 


JMP 


PWRONA 


. BYTE 





»=KEYBDV 



(CLOSE) 



(STATUS) 
(SPECIAL) 



;R0M FILLER BYTE 



KEYBOARD HANDLER ENTRY POINT 



KBDHND: 


. WORD 


RETURl-1 




. WORD 


RETURl-1 




. WORD 


KGETCH-1 




. WORD 


NOFUNC-1 




. WORD 


RETURl-1 




. WORD 


NOFUNC-1 




JMP 


PWRONA 



. BYTE 



( CLOSE ) 

(DUTCH) 

(STATUS) 

(SPECIAL) 

iROM FILLER BYTE 



INTERRUPT VECTOR TABLE ENTRY 
»=VCTABL- INTABS+VKEYBD 
.WORD PIRQ5 i KEYBOARD IRQ INTERRUPT VECTOR 



ERR LINE 


ADDR 


Bl 


B2 


B3 


4083 










4084 










4085 










4086 


F3E4 


A9 


FF 




4087 


F3E6 


8D 


FC 


02 


4088 


F3E9 


AO 


E6 


02 


4089 


F3EC 


29 


FO 




4090 


F3EE 


85 


6A 




4091 


F3F0 


A9 


40 




4092 


F3F2 


8D 


BE 


02 


4093 


F3F5 


60 
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PWRONA: 



»=KBDORG 

LDA 
STA 
LDA 
AND 
STA 
LDA 
STA 
RTS 



#*FF 

CH 

MEMTOP+1 

#*F0 

RAMTOP 

»*40 

SHFLOK 



i INSURE 4R PAGE BOUNDARY 

i DEFAULT, TO UPPER CASE ALPHA AT PWRON 

i POWER ON COMPLETED 



ERR LINE 


ADDR 


Bl 


B2 


B3 


4094 










4095 










4096 










4097 










4098 










4099 


F3F6 


A5 


2B 




4100 


F3F8 


29 


OF 




4101 


F3FA 


DO 


08 




4102 


F3FC 


A5 


2A 




4103 


F3FE 


29 


OF 




4104 


F400 


85 


2A 




4105 


F402 


A9 


00 




4106 


F404 


85 


57 




4107 


F406 


A9 


EO 




4108 


F408 


8D 


F4 


02 


4109 


F40B 


A9 


02 




4110 


F40D 


8D 


F3 


02 


4111 


F410 


8D 


2F 


02 


4112 


F413 


A9 


01 




4113 


F415 


85 


4C 




4114 


F417 


A9 


CO 




4115 


F419 


05 


10 




4116 


F4iB 


85 


10 




4117 


F41D 


8D 


OE 


D2 


4118 


F420 


A9 


00 




4119 


F422 


8D 


93 


02 


4120 


F425 


85 


64 




4121 


F427 


85 


7B 




4122 


F429 


8D 


FO 


02 


4123 


F42C 


AO 


OE 




4124 


F42E 


A9 


01 




4125 


F430 


99 


A3 


02 


4126 


F433 


88 






4127 


F434 


10 


FA 




4128 


F436 


A2 


04 




4129 


F438 


BD 


CI 


FE 


4130 


F43B 


9D 


C4 


02 


4131 


F43E 


CA 






4132 


F43F 


10 


F7 




4133 


F441 


A4 


6A 




4134 


F443 


88 






4135 


F444 


8C 


95 


02 


4136 


F447 


A9 


60 




4137 


F449 


8D 


94 


02 


4138 


F44C 


A6 


57 




4139 


F44E 


BD 


69 


FE 


4140 


F451 


DO 


04 




4141 


F453 


A9 


91 




4142 


F455 


85 


4C 




4143 


F457 


85 


51 




4144 


F459 


A5 


6A 




4145 


F45B 


85 


65 




4146 


F45D 


BC 


45 


FE 


4147 


F460 


A9 


28 
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BEGIN DISPLAY HANDLER OPEN PROCESSING 



DOPEN: 



EOPEN: 



OPNCOM: 



CLRTBS: 



D0PEN8: 



OPNERR: 
DOPENA: 

DOPEN 1: 



LDA 
AND 
BNE 
LDA 
AND 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
STA 
LDA 
STA 
LDA 
ORA 
STA 
STA 
LDA 
STA 
STA 
STA 
STA 
LDY 
LDA 
STA 
DEY 
BPL 
LDX 
LDA 
STA 
DEX 
BPL 
LDY 
DEY 
STY 
LDA 
STA 
LDX 
LDA 
BNE 
LDA 
STA 
STA 
LDA 
STA 
LDY 
LDA 



ICAX2Z 

#*F 

OPNCOM 

ICAXIZ 

#*F 

ICAXIZ 

#0 

DINDEX 

#*E0 

CHBAS 

#2 

CHACT 

SDMCTL 

#SUCCES 

DSTAT 

#*C0 

POKMSK 

POKMSK 

IRQEN 

#0 

T INDEX 

ADRESS 

SWPFLG 

CRSINH 

#14 

#1 

TABMAP, Y 

CLRTBS 
#4 

COLRTB, X 
COLORO, X 

D0PEN8 
RAMTOP 

TXTMSC+l 

#*60 

TXTMSC 

DINDEX 

ANCONV, X 

DOPENA 

#BADNOD 

DSTAT 

HOLDl 

RAMTOP 

ADRESS+1 

ALOCAT, X 

#40 



; GET AUX 2 BYTE 

; IF MODE ZERO, CLEAR ICAXIZ 

; CLEAR "CLR INHIBIT" AND "MXD MODE" BITS 



; INITIALIZE GLOBAL VBLANK RAM 



i TURN OFF DMA NEXT VBLANK 

; CLEAR STATUS 
; DO IRQEN 



jTEXT index must always BE O 



TURN CURSOR ON AT OPEN 

CLEAR TAB STOPS 

INIT TAB STOPS TO EVERY 8 CHARACTERS 



i LOAD COLOR REGISTERS 



iDO TXTMSC=*2C40 (IF MEMTOP=3000) 



CONVERT IT TO ANTIC CODE 
IF ZERO, IT IS ILLEGAL 
SET ERROR STATUS 



;SET UP AN INDIRECT POINTER 

; ALLOCATE N BLOCKS OF 40 BYTES 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


4148 


F462 


20 


21 


F9 


4149 


F465 


88 






4150 


F466 


DO 


F8 




4151 


F468 


AD 


6F 


02 


4152 


F46B 


29 


3F 




4153 


F46D 


85 


67 




4154 


F46F 


A8 






4155 


F470 


EO 


08 




4156 


F472 


90 


17 




4157 


F474 


8A 






4158 


F475 


6A 






4159 


F476 


6A 






4160 


F477 


6A 






4161 


F478 


29 


CO 




4162 


F47A 


05 


67 




4163 


F47C 


A8 






4164 


F47D 


A9 


10 




4165 


F47F 


20 


21 


F9 


4166 


F482 


EO 


OB 




4167 


F484 


DO 


05 




4168 


F486 


A9 


06 




4169 


F488 


8D 


C8 


02 


4170 


F48B 


8C 


6F 


02 


4171 


F48E 


A5 


64 




4172 


F490 


85 


58 




4173 


F492 


A5 


65 




4174 


F494 


85 


59 




4175 


F496 


AD 


OB 


D4 


4176 


F499 


C9 


7A 




4177 


F49B 


DO 


F9 




4178 


F49D 


20 


IF 


F9 


4179 


F4A0 


BD 


75 


FE 


4180 


F4A3 


FO 


06 




4181 


F4A5 


A9 


FF 




4182 


F4A7 


85 


64 




4183 


F4A9 


C6 


65 




4184 


F4AB 


A5 


64 




4185 


F4AD 


85 


68 




4186 


F4AF 


A5 


65 




4187 


F4B1 


85 


69 




4188 


F4B3 


20 


13 


F9 


4189 


F4B6 


A9 


41 




4190 


F4B8 


20 


17 


F9 


4191 


F4BB 


86 


66 




4192 


F4BD 


A9 


18 




4193 


F4BF 


8D 


BF 


02 


4194 


F4C2 


A5 


57 




4195 


F4C4 


C9 


09 




4196 


F4C6 


BO 


2D 




4197 


F4C8 


A5 


2A 




4198 


F4CA 


29 


10 




4199 


F4CC 


FO 


27 




4200 


F4CE 


A9 


04 




4201 


F4D0 


8D 


BF 


02 
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PAWt 



•t'O 



JSR 
DEY 
BNE 
LDA 
AND 
STA 
TAY 
CPX 
BCC 
TXA 
ROR 
ROR 
ROR 
AND 
ORA 
TAY 
LDA 
JSR 
CPX 
BNE 
LDA 
STA 

N0T8: STY 
LDA 
STA 
LDA 
STA 

VBWAIT: LDA 
CMP 
BNE 
JSR 
LDA 
BEO 
LDA 
STA 
DEC 

NOMOD: LDA 
STA 
LDA 
STA 
JSR 
LDA 
JSR 
STX 
LDA 
STA 
LDA 
CMP 
BCS 
LDA 
AND 
BEQ 
LDA 
STA 



DBSUB 

DOPENl 
OPRIOR 
#*3F 
OPNTMP+i 

#8 
N0T8 

A 

A 

A 

#*C0 

OPNTMP+1 

#16 

DBSUB 

#11 

N0T8 

#6 

COLOR 4 

OPRIOR 

ADRESS 

SAVMSC 

ADRESS-H 

SAVMSC +1 

VCOUNT 

#*7A 

VBWAIT 

DBDEC 

PAGETB. X 

NOMOD 

#*FF 

ADRESS 

ADRESS+1 

ADRESS 

SAVADR 

ADRESS+1 

SAVADR+i 

DBDDEC 

#*41 

STORE 

OPNTMP 

#24 

BOTSCR 

DINDEX 

#9 

NOTMXD 

ICAXIZ 

#*10 

NOTMXD 

#4 

BOTSCR 



i CLEAR GTIA MODES 

;TEST IF 320X1 
.GET 2 LOW BITS 

/NOW 2 TOP BITS 



i SUBTRACT 16 MORE FOR PAGE BOUNDARY 

TEST MODE 11 
IF MODE =11 
PUT GTIA LUM VALUE INTO BACKGROUND REGISTER 

i STORE NEW PRIORITY 

i SAVE MEMORY SCAN COUNTER ADDRESS 



;WAIT FOR NEXT VBLANK BEFORE MESSING 
;WITH THE DISPLAY LIST 

START PUTTING DISPLAY LIST RIGHT UNDER RAM 
TEST IF DISPLAY LIST WILL BE IN TROUBLE 
OF CROSSING A 256 BYTE PAGE BOUNDARY 
IF SO. DROP DOWN A PAGE 



;SAVE END OF DISPLAY LIST FOR LATER 



; (DOUBLE BYTE DOUBLE DECREMENT) 

; (ANTIC) WAIT FOR VBLANK AND JMP TO TOP 



i INITIALIZE BOTSCR 

i DISALLOW MIXED MODE IF MODE. GE. 9 

iTEST MIXED MODE 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


4202 


F4D3 


A2 


02 




4203 


F4D5 


A9 


02 




4204 


F4D7 


20 


17 


F9 


4205 


F4DA 


CA 






4206 


F4DB 


10 


F8 




4207 


F4DD 


A4 


6A 




4208 


F4DF 


88 






4209 


F4E0 


98 






4210 


F4E1 


20 


17 


F9 


4211 


F4E4 


A9 


60 




4212 


F4E6 


20 


17 


F9 


4213 


F4E9 


A9 


42 




4214 


F4EB 


20 


17 


F9 


4215 


F4EE 


18 






4216 


F4EF 


A9 


OC 




4217 


F4F1 


65 


66 




4218 


F4F3 


85 


66 




4219 


F4F5 


A4 


66 




4220 


F4F7 


BE 


51 


FE 


4221 


F4FA 


A5 


51 




4222 


F4FC 


20 


17 


F9 


4223 


F4FF 


CA 






4224 


F500 


DO 


F8 




4225 


F502 


A5 


57 




4226 


F504 


C9 


08 




4227 


F506 


90 


IC 




4228 


F508 


A2 


5D 




4229 


F50A 


A5 


6A 




4230 


F50C 


38 






4231 


F50D 


E9 


10 




4232 


F50F 


20 


17 


F9 


4233 


F512 


A9 


00 




4234 


F514 


20 


17 


F9 


4235 


F517 


A9 


4F 




4236 


F519 


20 


17 


F9 


4237 


F51C 


A5 


51 




4238 


F51E 


20 


17 


F9 


4239 


F521 


CA 






4240 


F522 


DO 


F8 




4241 


F524 


A5 


59 




4242 


F526 


20 


17 


F9 


4243 


F529 


A5 


58 




4244 


F52B 


20 


17 


F9 


4245 


F52E 


A5 


51 




4246 


F530 


09 


40 




4247 


F532 


20 


17 


F9 


4248 


F535 


A9 


70 




4249 


F537 


20 


17 


F9 


4250 


F53A 


A9 


70 




4251 


F53C 


20 


17 


F9 


4252 


F53F 


A5 


64 




4253 


F541 


8D 


30 


02 


4254 


F544 


A5 


65 




4255 


F546 


8D 


31 


02 



DISPLAY HANDLER 

LDX 
D0PEN2: LDA 

JSR 

DEX 

BPL 

LDY 

DEY 

TYA 

JSR 

LDA 

JSR 

LDA 

JSR 

CLC 

LDA 

ADC 

STA 
NOTMXD: LDY 

LDX 
D0PEN3: LDA 

JSR 

DEX 

BNE 

LDA 

CMP 

BCC 

LDX 

LDA 

SEC 

SBC 

JSR 

LDA 

JSR 

LDA 

JSR 
D0PEN4: LDA 

JSR 

DEX 

BNE 
D0PEN5: LDA 

JSR 

LDA 

JSR 

LDA 

ORA 

JSR 

LDA 

JSR 

LDA 

JSR 

LDA 

STA 

LDA 

STA 



— 10-30-78 



DISPLC 



PAGE 96 



#2 
#2 
STORE 

D0PEN2 
RAMTOP 



ADD 4 LINES OF TEXT AT BOTTOM OF SCREEN 



i RELOAD MSC FOR TEXT 



STORE 

#*60 

STORE 

#*42 

STORE 

#MXDMDE-NUMDLE 

OPNTMP 

OPNTMP 

OPNTMP 

NUMDLE, Y 

HOLDl 

STORE 



D0PEN3 

DINDEX 

#8 

D0PEN5 

#93 

RAMTOP 

#*10 

STORE 

#0 

STORE 

#*4F 

STORE 

HOLDl 

STORE 

D0PEN4 

SAVMSC+1 

STORE 

SAVMSC 

STORE 

HOLDl 

#*40 

STORE 

#*70 

STORE 

#»70 

STORE 

ADRESS 

SDLSTL 

ADRESS+1 

SDLSTL-H 



POINT X AT MIXED MODE TABLE 



GET NUMBER OF DISPLAY LIST ENTRIES 
STORE N DLE'S 



DO THE MESSY 320X1 PROBLEM 



GET REMAINING NUMBER OF DLE'S 
RELOAD MEMORY SCAN COUNTER 



i (ANTIC) RELOAD MSC CODE 
i DO REMAINING DLE'S 

i POLISH OFF DISPLAY LIST 



24 BLANK LINES 



SAVE DISPLAY LIST ADDRESS 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


4256 


F549 


A9 


70 




4257 


F54B 


20 


17 


F9 


4258 


F54E 


A5 


64 




4259 


F550 


8D 


E5 


02 


4260 


F553 


A5 


65 




4261 


F555 


8D 


E6 


02 


4262 


F558 


A5 


68 




4263 


F55A 


85 


64 




4264 


F55C 


A5 


69 




4265 


F55E 


85 


65 




4266 


F560 


AD 


31 


02 


4267 


F563 


20 


17 


F9 


4268 


F566 


AD 


30 


02 


4269 


F569 


20 


17 


F9 


4270 


F56C 


A5 


4C 




4271 


F56E 


10 


07 




4272 


F570 


48 






4273 


F571 


20 


FC 


F3 


4274 


F574 


68 






4275 


F575 


A8 






4276 


F576 


60 






4277 


F577 


A5 


2A 




4278 


F579 


29 


20 




4279 


F57B 


DO 


OB 




4280 


F57D 


20 


B9 


F7 


4281 


F580 


8D 


90 


02 


4282 


F583 


A5 


52 




4283 


F585 


8D 


91 


02 


4284 


F588 


A9 


22 




4285 


F58A 


OD 


2F 


02 


4286 


F58D 


8D 


2F 


02 


4287 


F590 


4C 


21 


F6 


4288 










4289 










4290 


F593 


20 


96 


FA 


4291 


F596 


20 


A2 


F5 


4292 


F599 


20 


32 


FB 


4293 


F59C 


20 


D4 


F9 


4294 


F59F 


4C 


34 


F6 


4295 


F5A2 


20 


47 


F9 


4296 


F5A5 


Bl 


64 




4297 


F5A7 


2D 


AO 


02 


4298 


F5AA 


46 


6F 




4299 


F5AC 


BO 


03 




4300 


F5AE 


4A 






4301 


F5AF 


10 


F9 




4302 


F5B1 


8D 


FA 


02 


4303 


F5B4 


C9 


00 




4304 


F5B6 


60 






4305 










4306 










4307 










4308 


F5B7 


8D 


FB 


02 


4309 


F5BA 


20 


96 


FA 



DISPLAY HANDLER 

LDA 

JSR 

LDA 

STA 

LDA 

STA 

LDA 

STA 

LDA 

STA 

LDA 

JSR 

LDA 

JSR 

LDA 

BPL 

PHA 

JSR 

PLA 

TAY 

RTS 
D0PEN9: LDA 

AND 

BNE 

JSR 

STA 

LDA 

STA 
D0PEN7: LDA 

OR A 

STA 

JMP 



OETCH: JSR 
JSR 
JSR 
JSR 
JMP 

GETPLT: JSR 
LDA 
AND 

SHIFTD: LSR 
BCS 
LSR 
BPL 

SHIFTl: STA 
CMP 
RTS 



#*70 

STORE 

ADRESS 

MEMTOP 

ADRESS+1 

MEMTOP+1 

SAVADR 

ADRESS 

SAVADR+1 

ADRESS+1 

SDLSTL+i 

STORE 

SDLSTL 

STORE 

DSTAT 

D0PEN9 

EOPEN 



ICAXIZ 

#*20 

D0PEN7 

CLRSCR 

TXTROW 

LMARGN 

TXTCOL 

#$22 

SDMCTL 

SDMCTL 

RETUR2 



10-30-78 — DISPLC 

ADD LAST BLANK LINE ENTRY 
POSITION ADRESS=SDLSTL-1 
STORE NEW MEMTOP 



PAGE 



97 



DUTCH: 



STA 
JSR 



RANGE 

GETPLT 

INATAC 

INCRSB 

RETURl 

CONVRT 

(ADRESS), Y 

DMASK 

SHFAMT 

SHIFTl 

A 

SHIFTD 

CHAR 

#0 



ATACHR 
RANGE 



i IF ERROR OCURRED ON ALLOCATION, OPEN THE ED 

SAVE STATUS 

OPEN THE EDITOR 

RESTORE STATUS 

AND RETURN IT TO CIO 

; TEST CLEAR INHIBIT BIT 



.CLEAR SCREEN 

;AND HOME TEXT CURSOR (AC IS ZERO) 



; EVERYTHING ELSE IS SET UP 
i SO TURN ON DMACTL 



GETCH DOES INCRSR, GETPLT DOESN'T 
CONVERT INTERNAL CODE TO ATASC 1 1 

CONVERT ROW/COLUMN TO ADRESS 

SHIFT DATA DOWN TO LOW BITS 

(UNCONDITIONAL) 
RESTORE FLAGS ALSO 



ERR LINE 


ADDR 


Bl 


B2 


B3 


4310 










4311 


F5BD 


AD 


FB 


02 


4312 


F5C0 


C9 


7D 




4313 


F5C2 


DO 


06 




4314 


F5C4 


20 


B9 


F7 


4315 


F5C7 


4C 


21 


F6 


4316 


F5CA 


AD 


FB 


02 


4317 


F5CD 


C9 


9B 




4318 


F5CF 


DO 


06 




4319 


F5D1 


20 


30 


FA 


4320 


F5D4 


4C 


21 


F6 


4321 


F5D7 


20 


EO 


F5 


4322 


F5DA 


20 


D8 


F9 


4323 


F5DD 


4C 


21 


F6 


4324 










4325 










4326 


F5E0 


AD 


FF 


02 


4327 


F5E3 


DO 


FB 




4328 


F5E5 


A2 


02 




4329 


F5E7 


B5 


54 




4330 


F5E9 


95 


5A 




4331 


F5EB 


CA 






4332 


F5EC 


10 


F9 




4333 


F5EE 


AD 


FB 


02 


4334 


F5F1 


A8 






4335 


F5F2 


2A 






4336 


F5F3 


2A 






4337 


F5F4 


2A 






4338 


F5F5 


2A 






4339 


F5F6 


29 


03 




4340 


F5F8 


AA 






4341 


F5F9 


98 






4342 


F5FA 


29 


9F 




4343 


F5FC 


ID 


F6 


FE 


4344 


F5FF 


8D 


FA 


02 


4345 


F602 


20 


47 


F9 


4346 


F605 


AD 


FA 


02 


4347 


F60S 


46 


6F 




4348 


F60A 


BO 


04 




4349 


F60C 


OA 






4350 


F60D 


4C 


OS 


F6 


4351 


F610 


2D 


AO 


02 


4352 


F613 


85 


50 




4353 


F615 


AD 


AO 


02 


4354 


F618 


49 


FF 




4355 


F61A 


31 


64 




4356 


F61C 


05 


50 




4357 


F61E 


91 


64 




4358 


F620 


60 






4359 










4360 










4361 


F621 


20 


A2 


F5 


4362 


F624 


85 


5D 




4363 


F626 


A6 


57 
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; JSR 

OUTCHA: LDA 
CMP 
BNE 
JSR 
JMP 

OUTCHE: LDA 
CMP 
BNE 
JSR 
JMP 

OUTCHB: JSR 
JSR 
JMP 



OUTPLT; 



CRLOOP: 



0UTCH2: 



SHIFTU: 



SHIFT2: 



RETUR2: 



LDA 
BNE 
LDX 
LDA 
STA 
DEX 
BPL 
LDA 
TAY 
ROL 
ROL 
ROL 
ROL 
AND 
TAX 
TYA 
AND 
OR A 
STA 
JSR 
LDA 
LSR 
BCS 
ASL 
JMP 
AND 
STA 
LDA 
EOR 
AND 
OR A 
STA 
RTS 



JSR 
STA 
LDX 



OFFCRS 

ATACHR 

#CLRCOD 

OUTCHE 

CLRSCR 

RETUR2 

ATACHR 

#CR 

OUTCHB 

DOCRWS 

RETUR2 

OUTPLT 

INCRSR 

RETUR2 



SSFLAG 
OUTPLT 
#2 

ROWCRS, X 
OLDROW, X 

CRLOOP 
ATACHR 

A 
A 
A 
A 
#3 



#*9F 

ATAINT, X 

CHAR 

CONVRT 

CHAR 

SHFAMT 

SHIFT2 

A 

SHIFTU 

DMASK 

TMPCHR 

DMASK 

#*FF 

(ADRESS), 

TMPCHR 

(ADRESS), 



; TEST FOR CLEAR SCREEN 



; TEST FOR CARRIAGE RETURN 



; DO CR 



; ****»LOOP HERE IF START/STOP FLAG IS NON~0 



;SAVE CURSOR LOCATION FOR DRAW LINE TO DRAW 



; CONVERT ATASCI I (ATACHR ) TO INTERNAL ( CHAR ) 
; SAVE ATACHR 



X HAS INDEX INTO ATAINT 
RESTORE ATACHR 
STRIP OFF COLUMN ADDRESS 
OR IN NEW COLUMN ADDRESS 



SHIFT UP TO PROPER POSITION 



; SAVE SHIFTED DATA 
; INVERT MASK 

i MASK OFF OLD DATA 
;0R IN NEW DATA 



i DO CURSOR ON THE WAY OUT 



GETPLT 
OLDCHR 
DINDEX /GRAPHICS HAVE INVISIBLE CURSOR 



ERR LINE 


ADDR 


Bl 


B2 


B3 


4364 


F628 


DO 


OA 




4365 


F62A 


AE 


FO 


02 


4366 


F62D 


DO 


05 




4367 


F62F 


49 


80 




4368 


F631 


20 


FF 


F5 


4369 


F634 


A4 


4C 




4370 


F636 


A9 


01 




4371 


F638 


85 


4C 




4372 


F63A 


AD 


FB 


02 


4373 


F63D 


60 






4374 










4375 










4376 










4377 










4378 
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BNE 


RETURl 




LDX 


CRSINH ; 




BNE 


RETURl 




EOR 


#*80 




JSR 


0UTCH2 ; 


RETURl: 


LDY 


DSTAT ; 




LDA 


#SUCCES 




STA 


DSTAT i 




LDA 


ATACHR 


NOFUNC : 


RTS 





; TEST CURSOR INHIBIT 

TOGGLE MSB 
DISPLAY IT 
RETURN TO CIO WITH STATUS IN Y 

SET STATUS= SUCCESSFUL COMPLETION 
PUT ATACHR IN AC FOR RETURN TO CIO 
(NON-EXISTENT FUNCTION RETURN POINT) 



; END OF DISPLAY HANDLER 



ERR LINE ADDR Bl B2 B3 B4 
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4379 












PAGE 




4380 
















4381 
















4382 
















4383 
















4384 


F63E 


20 


B3 


FC 


EGETCH: 


JSR 


SWAP 


4385 


F641 


20 


88 


FA 




JSR 


ERANGE 


4386 


F644 


A5 


6B 






LDA 


BUFCNT 


4387 


F646 


DO 


34 






BNE 


E0ETC3 


4388 


F648 


A5 


54 






LDA 


ROWCRS 


4389 


F64A 


85 


6C 






STA 


BUFSTR 


4390 


F64C 


A5 


55 






LDA 


COLORS 


4391 


F64E 


85 


6D 






STA 


BUFSTR+1 


4392 


F650 


20 


E2 


F6 


EGETC 1 : 


JSR 


KGETCH ; LET 


4393 


F653 


84 


4C 






STY 


DSTAT 


4394 


F655 


AD 


FB 


02 




LDA 


ATACHR 


4395 


F658 


C9 


9B 






CMP 


#CR 


4396 


F65A 


FO 


12 






BEQ 


EGETC2 


4397 


F65C 


20 


AD 


F6 




JSR 


DOSS 


4398 


F65F 


20 


B3 


FC 




JSR 


SWAP 


4399 


F662 


A5 


63 






LDA 


LOGCOL 


4400 


F664 


C9 


71 






CMP 


#113 


4401 


F666 


DO 


03 






BNE 


EGETC6 


4402 


F668 


20 


OA 


F9 




JSR 


BELL 


4403 


F66B 


4C 


50 


F6 i 


EGETC6: 


JMP 


EGETC 1 


4404 


F66E 


20 


E4 


FA i 


EGETC2: 


JSR 


OFFCRS 


4405 


F671 


20 


00 


FC 




JSR 


DOBUFC 


4406 


F674 


A5 


6C 






LDA 


BUFSTR 


4407 


F676 


85 


54 






STA 


ROWCRS 


4408 


F678 


A5 


6D 






LDA 


BUFSTR+1 


4409 


F67A 


85 


55 






STA 


COLORS 


4410 


F67C 


A5 


6B 


EGETC3: 


LDA 


BUFCNT 


4411 


F67E 


FO 


11 






BEQ 


EGETC 5 


4412 


F680 


C6 


6B 


1 


EGETC 7: 


DEC 


BUFCNT 


4413 


F682 


FO 


OD 






BEQ 


EGETC 5 


4414 


F684 


A5 


4C 






LDA 


DSTAT 


4415 


F686 


30 


F8 






BMI 


EGETC 7 


4416 


F688 


20 


93 


F5 




JSR 


GETCH 


4417 


F68B 


8D 


FB 


02 




STA 


ATACHR 


4418 


F68E 


4C 


B3 


FC 




JMP 


SWAP 


4419 


F691 


20 


30 


FA EGETC5: 


JSR 


DOCRWS 


4420 


F694 


A9 


9B 






LDA 


#CR 


4421 


F696 


8D 


FB 


02 




STA 


ATACHR 


4422 


F699 


20 


21 


F6 




JSR 


RETUR2 


4423 


F69C 


84 


4C 






STY 


DSTAT 


4424 


F69E 


4C 


B3 


FC 




JMP 


SWAP 


4425 
















4426 


F6A1 


6C 


64 


00 


JSRIND: 


JMP 


(ADRESS) 


4427 
















4428 


F6A4 


8D 


FB 


02 1 


EOUTCH: 


STA 


ATACHR 


4429 


F6A7 


20 


B3 


FC 




JSR 


SWAP 


4430 


F6AA 


20 


88 


FA 




JSR 


ERANGE 


4431 


F6AD 


20 


E4 


FA 1 


OOSS: 


JSR 


OFFCRS 


4432 


F6B0 


20 


8D 


FC 




JSR 


TSTCTL 



ANYTHING IN THE BUFFER? 

YES 

NO, SO SAVE BUFFER START ADDRESS 



'S FILL OUR BUFFER 
SAVE KEYBOARD STATUS 
i TEST FOR CR 



NO, SO PRINT IT 

JSR DOSS DID SWAP SO SWAP BACK 

BEEP IF NEAPING LOGICAL COL 120 



;GET BUFFER COUNT 
; RETURN A CHARACTER 



; AND RETURN TILL BUFCNT=0 

; IF ERR, LOOP ON EGETC7 UNTIL BUFR IS EMPTIE 



AND RETURN WITHOUT TURNING CURSOR BACK ON 
DO REAL CARRIAGE RETURN 
AND RETURN EOL 

TURN ON CURSOR THEN SWAP 

SAVE KEYBOARD STATUS 

AND RETURN THROUGH RETURl 

; JSR TO THIS CAUSES JSR INDIRECT 

; SAVE ATASC 1 1 VALUE 



TURN OFF CURSOR 

TEST FOR CONTROL CHARACTERS (Z=l IF CTL> 



ERR LINE 


ADDR 


Bi 


B2 


B3 B4 


4433 


F6B3 


FO 


09 




4434 


F6B5 


OE 


A2 


02 


4435 


F6B8 


20 


CA 


F5 


4436 


F6BB 


4C 


B3 


FC 


4437 


F6BE 


AD 


FE 


02 


4438 


F6C1 


OD 


A2 


02 


4439 


F6C4 


DO 


EF 




4440 


F6C6 


OE 


A2 


02 


4441 


F6C9 


E8 






4442 


F6CA 


BD 


C6 


FE 


4443 


F6CD 


85 


64 




4444 


F6CF 


BD 


C7 


FE 


4445 


F6D2 


85 


65 




4446 


F6D4 


20 


Al 


F6 


4447 


F6D7 


20 


21 


F6 


4448 


F6DA 


4C 


B3 


FC 


4449 










4450 










4451 










4452 










4453 










4454 










4455 










4456 










4457 










4458 










4459 










4460 










4461 


F6DD 


A9 


FF 




4462 


F6DF 


8D 


FC 


02 


4463 


F6E2 


A5 


2A 




4464 


F6E4 


4A 






4465 


F6E5 


BO 


62 




4466 


F6E7 


A9 


80 




4467 


F6E9 


A6 


11 




4468 


F6EB 


FO 


58 




4469 


F6ED 


AD 


FC 


02 


4470 


F6F0 


C9 


FF 




4471 


F6F2 


FO 


EE 




4472 


F6F4 


85 


7C 




4473 


F6F6 


A2 


FF 




4474 


F6F8 


8E 


FC 


02 


4475 


F6FB 


20 


D8 


FC 


4476 


F6FE 


AA 






4477 


F6FF 


EO 


CO 




4478 


F701 


90 


02 




4479 


F703 


A2 


03 




4480 


F705 


BD 


FE 


FE 


4481 


F708 


8D 


FB 


02 


4482 


F70B 


C9 


80 




4483 


F70D 


FO 


CE 




4484 


F70F 


C9 


81 




4485 


F711 


DO 


OB 




4486 


F713 


AD 


B6 


02 
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E0UTC6: 



BEQ 
ASL 
JSR 
ERETN: JMP 
E0UTC5: LDA 
OR A 
BNE 
ASL 
INX 
LDA 
STA 
LDA 
STA 
JSR 
JSR 
JMP 



E0UTC5 

ESC FLO 

OUTCHE 

SWAP 

DSPFLG 

ESCFLG 

E0UTC6 

ESCFLG 

CNTRLS, X 

ADRESS 

CNTRLS+i, X 

ADRESS+1 

JSRIND 

RETUR2 

SWAP 



END SCREEN EDITOR. 



BEGIN KEYBOARD HANDLER 



K0ETC2: LDA 
STA 

KGETCH: LDA 
LSR 
BCS 
LDA 
LDX 
BEQ 
LDA 
CMP 
BEQ 
STA 
LDX 
STX 
JSR 

KGETC3: TAX 
CPX 
BCC 
LDX 

ASCCOl: LDA 
STA 
CMP 
BEQ 
CMP 
BNE 
LDA 



#*FF 

CH 

ICAXIZ 

A 

GETOUT 

#BRKABT 

BRKKEY 

K7 

CH 

#*FF 

KGETCH 

HOLDCH 

#*FF 

CH 

CLICK 

#*C0 

ASCCOl 

#3 

ATASC I , X 

ATACHR 

#*80 

KGETC2 

#*81 

KOETC 1 

INVFLG 



; ESCFLG ONLY WORKS ONCE 

; AND RETURN THROUGH RETURl 
) DO DSPFLG AND ESCFLG 

J IF NON-0 DISPLAY RATHER THAN EXECUTE IT 

i PROCESS CONTROL CHARACTERS 

; GET DISPLACEMENT INTO ROUTINE 

i GET HIGH BYTE 

DO COMPUTED JSR 

DO CURSOR 

ALL DONE SO RETURN THROUGH RETURl 



i TEST LSB OF AUXl FOR SPECIAL EDITOR READ MO 



; TEST BREAK 

; IF BREAK, PUT BRKABT IN DSTAT AND CR IN ATA 



i SAVE CH FOR SHIFT LOCK PROC 
i "CLEAR" CH 

DO KEYBOARD AUDIO FEEDBACK (A IS OK) 

DO ASCCON 

TEST FOR CTL & SHIFT TOGETHER 

; BAD CODE 

i DONE 

; DO NULLS 

; CHECK ATARI KEY 



ERR LINE ADDR Bl B2 B3 B4 
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4487 
4488 
4489 
4490 
4491 
4492 
4493 
4494 
4495 
4496 
4497 
4498 
4499 
4500 
4501 
4502 
4503 
4504 
4505 
4506 
4507 
4508 
4509 
4510 
4511 
4512 
4513 
4514 
4515 
4516 
4517 
4518 
4519 
4520 
4521 
4522 
4523 
4524 
4525 
4526 
4527 
4528 
4529 
4530 
4531 



F716 
F718 
F71B 
F71E 
F720 
F722 
F724 
F727 
F729 
F72B 
F72D 
F72F 
F732 
F734 
F736 
F738 
F73A 
F73D 
F73F 
F741 
F743 
F745 
F747 
F749 
F74B 
F74D 
F74F 
F751 
F753 
F756 
F758 
F75A 
F75C 
F75E 
F761 
F763 
F765 
F768 
F76B 
F76D 
F770 
F773 
F776 



49 80 
8D B6 02 
4C DD F6 
C9 82 
DO 07 
A9 00 
8D BE 02 
FO B4 
C9 83 
DO 07 
A9 40 
8D BE 02 
DO A9 
C9 84 
DO 07 
A9 80 
8D BE 02 
DO 9E 
C9 85 
DO OA 
A9 88 
85 4C 
85 11 
A9 9B 
DO 26 
A5 7C 
C9 40 
BO 15 
AD FB 02 
C9 61 
90 OE 
C9 7B 
BO OA 
AD BE 02 
FO 05 
05 7C 
4C FE F6 
20 8D FC 
FO 09 
AD FB 02 
4D B6 02 
8D FB 02 
4C 34 F6 



EOR 
STA 
JMP 

KGETCl: CMP 
BNE 
LDA 
STA 
BEQ 

Kl: CMP 
BNE 
LDA 
STA 
BNE 

K2: CMP 
BNE 
LDA 
STA 
BNE 

K3: CMP 
BNE 
LDA 

K7: STA 
STA 

GETOUT: LDA 
BNE 

K6: LDA 
CMP 
BCS 
LDA 
CMP 
BCC 
CMP 
BCS 
LDA 
BEQ 
ORA 
JMP 

K5: JSR 
BEQ 
LDA 
EOR 

K8: STA 

K4: JMP 



#$80 

INVFLG 

K0ETC2 

#$82 

Kl 

#0 

SHFLOK 

KGETC2 

#*83 

K2 

#*40 

SHFLOK 

KGETC2 

#*84 

K3 

#*80 

SHFLOK 

KGETC2 

#*85 

K6 

#EOFERR 

DSTAT 

BRKKEY 

#CR 

K8 

HOLDCH 

#$40 

K5 

ATACHR 

#$61 

K5 

#$7B 

K5 

SHFLOK 

K5 

HOLDCH 

KGETC3 

TSTCTL 

K4 

ATACHR 

INVFLG 

ATACHR 

RETURl 



; DONT RETURN A VALUE 
; CAPS /LOWER 

.CLEAR SHFLOK 



{SHIFT CAPS/LOWER 

; SHIFT BIT 

; CNTL CAPS/LOWER 

;CNTL BIT 

; DO EOF 



RESTORE BREAK 

PUT CR IN ATACHR 

(UNCONDITIONAL) 

PROCESS SHIFT LOCKS 

REGULAR SHIFT AND CONTROL TAKE PRECEDENCE 

OVER LOCK 

TEST FOR ALPHA 

LOWER CASE A 

NOT ALPHA IF LT 

LOWER CASE Z+1 

NOT ALPHA IF OE 

DO SHIFT/CONTROL LOCK 

IF NO LOCK. DONT RE-DO IT 

; DO RETRY 

; DONT INVERT MSB OF CONTROL CHARACTERS 



ALL DONE 



ERR LINE 


ADDR 


Bl 


B2 


B3 


4532 










4533 










4534 










4535 










4536 










4537 


F779 


A9 


80 




4538 


F77B 


8D 


A2 


02 


4539 


F77E 


60 






4540 


F77F 


C6 


54 




4541 


F781 


10 


06 




4542 


F783 


AE 


BF 


02 


4543 


F786 


CA 






4544 


F787 


86 


54 




4545 


F789 


4C 


5C 


FC 


4546 


F78C 


E6 


54 




4547 


F78E 


A5 


54 




4548 


F790 


CD 


BF 


02 


4549 


F793 


90 


F4 




4550 


F795 


A2 


00 




4551 


F797 


FO 


EE 




4552 


F799 


C6 


55 




4553 


F79B 


A5 


55 




4554 


F79D 


30 


04 




4555 


F79F 


C5 


52 




4556 


F7A1 


BO 


04 




4557 


F7A3 


A5 


53 




4558 


F7A5 


85 


55 




4559 


F7A7 


4C 


DD 


FB 


4560 


F7AA 


E6 


55 




4561 


F7AC 


A5 


55 




4562 


F7AE 


C5 


53 




4563 


F7B0 


90 


F5 




4564 


F7B2 


FO 


F3 




4565 


F7B4 


A5 


52 




4566 


F7B6 


4C 


A5 


F7 


4567 


F7B9 


20 


F3 


FC 


4568 


F7BC 


AO 


00 




4569 


F7BE 


98 






4570 


F7BF 


91 


64 




4571 


F7C1 


C8 






4572 


F7C2 


DO 


FB 




4573 


F7C4 


E6 


65 




4574 


F7C6 


A6 


65 




4575 


F7C8 


E4 


6A 




4576 


F7CA 


90 


F3 




4577 


F7CC 


A9 


FF 




4578 


F7CE 


99 


B2 


02 


4579 


F7D1 


C8 






4580 


F7D2 


CO 


04 




4581 


F7D4 


90 


F8 




4582 


F7D6 


20 


E4 


FC 


4583 


F7D9 


85 


63 




4584 


F7DB 


85 


6D 




4585 


F7DD 


A9 


00 
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CONTROL CHARACTER PROCESSORS 



ESCAPE 


LDA 


#«80 




STA 


ESCFLG 




RTS 




CRSRUP 


DEC 


ROWCRS 




BPL 


COMRET 




LDX 


BOTSCR 




DEX 




UPDNCM 


STX 


ROWCRS 


COMRET 


JMP 


STRBEG 


CRSRDN 


INC 


ROWCRS 




LDA 


ROWCRS 




CMP 


BOTSCR 




BCC 


COMRET 




LDX 


#0 




BEQ 


UPDNCM 


CRSRLF 


DEC 


COLCRS 




LDA 


COLORS 




BMI 


CRSRLl 




CMP 


LMARGN 




BCS 


COMREl 


CRSRLl 


LDA 


RMARON 


LFRTCM 


STA 


COLCRS 


COMREl 


JMP 


DOLCOL 


CRSRRT 


INC 


COLCRS 




LDA 


COLCRS 




CMP 


RMARGN 




BCC 


COMREl 




BEQ 


COMREl 




LDA 


LMARGN 




JMP 


LFRTCM 


CLRSCR 


JSR 


PUTMSC 




LDY 


#0 




TYA 




CLRSC2 


STA 
I NY 


(ADRESS), Y 




BNE 


CLRSC2 




INC 


ADRESS+1 




LDX 


ADRESS+1 




CPX 


RAMTOP 




BCC 


CLRSC2 




LDA 


#*FF 


CLRSC3 


STA 
I NY 


LOOMAP, Y 




CPY 


#4 




BCC 


CLRSC3 


HOME: 


JSR 


COLOR 




STA 


LOGCOL 




STA 


BUFSTR+1 




LDA 


#0 



;SET ESCAPE FLAG 



; WRAPAROUND 



; COL VERT ROW AND COL TO LOGCOL AND RETURN 

; (UNCONDITIONAL) 

;{IF LMARGN=0, THIS ELIMINATES PROBLEM CASE) 

.COLVERT ROW AND COL TO LOGCOL AND RETURN 

; (CAUSE BLE) 

; UNCONDITIONAL TO COMMON STORE 



iPUT IN THE AC 
; (AC IS ZERO) 



; CLEAN UP LOGICAL LINE BIT MAP 
i (Y IS ZERO AFTER CLRSC2 LOOP) 



.PLACE COLCRS AT LEFT EDGE 



ERR LINE ADDR Bl B2 B3 B4 
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4586 


F7DF 


85 


54 




4587 


F7E1 


85 


56 




4588 


F7E3 


85 


6C 




4589 


F7E5 


60 






4590 










4591 


F7E6 


A5 


63 




4592 


F7ES 


C5 


52 




4593 


F7EA 


FO 


21 




4594 


F7EC 


A5 


55 




4595 


F7EE 


C5 


52 




4596 


F7F0 


DO 


03 




4597 


F7F2 


20 


73 


FC 


4598 


F7F5 


20 


99 


F7 


4599 


F7F8 


A5 


55 




4600 


F7FA 


C5 


53 




4601 


F7FC 


DO 


07 




4602 


F7FE 


A5 


54 




4603 


F800 


FO 


03 




4604 


F802 


20 


7F 


F7 


4605 


F805 


A9 


20 




4606 


F807 


8D 


FB 


02 


4607 


F80A 


20 


EO 


F5 


4608 


F80D 


4C 


DD 


FB 


4609 


F810 


20 


AA 


F7 


4610 


F813 


A5 


55 




4611 


F815 


C5 


52 




4612 


F817 


DO 


OA 




4613 


F819 


20 


34 


FA 


4614 


F81C 


20 


20 


FB 


4615 


F81F 


90 


02 




4616 


F821 


BO 


07 




4617 


F823 


A5 


63 




4618 


F825 


20 


25 


FB 


4619 


F828 


90 


E6 




4620 


F82A 


4C 


DD 


FB 


4621 


F82D 


A5 


63 




4622 


F82F 


4C 


06 


FB 


4623 


F832 


A5 


63 




4624 


F834 


4C 


12 


FB 


4625 


F837 


20 


9D 


FC 


4626 


F83A 


20 


A2 


F5 


4627 


F83D 


85 


7D 




4628 


F83F 


A9 


00 




4629 


F841 


8D 


BB 


02 


4630 


F844 


20 


FF 


F5 


4631 


F847 


A5 


63 




4632 


F849 


48 






4633 


F84A 


20 


DC 


F9 


4634 


F84D 


68 






4635 


F84E 


C5 


63 




4636 


F850 


BO 


OC 




4637 


F852 


A5 


7D 




4638 


F854 


48 






4639 


F855 


20 


A2 


F5 



BS: 



BSA: 



BS3: 



BS2: 



BSl: 
TAB: 



TAB 1 : 

TAB2: 
SETTAB: 

CLRTAB: 

INSCHR: 



INSCH4: 



INSCHl: 



STA 
STA 
STA 
RTS 

LDA 
CMP 
BEQ 
LDA 
CMP 
BNE 
JSR 
JSR 
LDA 
CMP 
BNE 
LDA 
BEQ 
JSR 
LDA 
STA 
JSR 
JMP 
JSR 
LDA 
CMP 
BNE 
JSR 
JSR 
BCC 
BCS 
LDA 
JSR 
BCC 
JMP 
LDA 
JMP 
LDA 
JMP 
JSR 
JSR 
STA 
LDA 
STA 
JSR 
LDA 
PHA 
JSR 
PLA 
CMP 
BCS 
LDA 
PHA 
JSR 



ROWCRS 

COLCRS+i 

BUFSTR 



LOGCOL 

LMARGN 

BSl 

COLORS 

LMARGN 

BS3 

DELTIM 

CRSRLF 

COLCRS 

RMARGN 

BS2 

ROWCRS 

BS2 

CRSRUP 

#*20 

ATACHR 

OUTPLT 

DOLCOL 

CRSRRT 

COLCRS 

LMARGN 

TABl 

DOCR 

LOOGET 

TABl 

TAB2 

LOGCOL 

BITGET 

TAB 

DOLCOL 

LOGCOL 

BITSET 

LOGCOL 

BITCLR 

PHACRS 

GETPLT 

INSDAT 

#0 

SCRFLG 

0UTCH2 

LOGCOL 

INCRSA 

LOGCOL 
INSCH3 
INSDAT 

GETPLT 



; BACKSPACE 



; LEFT EDGE? 



; NO 

; YES, SEE IF LINE SHOULD BE DELETED 



iMAKE BACKSPACE DESTRUCTIVE 

AND RETURN 
BEGIN SEARCH 
TEST FOR NEW LINE 

NO 

DO CARRIAGE RETURN 

CHECK IF END OF LOGICAL LINE 

NO, CONTINUE 

(UNCONDITIONAL) 

CHECK FOR TAB STOP 

;N0, SO KEEP LOOKING 

i COLVERT ROW AND COL TO LOGCOL AND RETURN 

;SET BIT IN MAP AND RETURN 

; CLEAR " ' " 

; GET CHARACTER UNDER CURSOR 



STORE DATA 

SAVE LOGCOL: IF AFTER INCRSA LOGCOL IS 

< THAN IT IS NOW, END LOOP 

SPECIAL INCRSR ENTRY POINT 



;QUIT 
iKEEP GOING 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


4640 


F858 


85 


7D 




4641 


F85A 


68 






4642 


F85B 


4C 


44 


F8 


4643 


F85E 


20 


A8 


FC 


4644 


F861 


CE 


BB 


02 


4645 


F864 


30 


04 




4646 


F866 


C6 


54 




4647 


F868 


DO 


F7 




4648 


F86A 


4C 


DD 


FB 


4649 










4650 










4651 


F86D 


20 


9D 


FC 


4652 


F870 


20 


47 


F9 


4653 


F873 


A5 


64 




4654 


F875 


85 


68 




4655 


F877 


A5 


65 




4656 


F879 


85 


69 




4657 


F87B 


A5 


63 




4658 


F87D 


48 






4659 


F87E 


20 


D4 


F9 


4660 


F881 


68 






4661 


F882 


C5 


63 




4662 


F884 


BO 


10 




4663 


F886 


A5 


54 




4664 


F888 


CD 


BF 


02 


4665 


F88B 


BO 


09 




4666 


F88D 


20 


A2 


F5 


4667 


F890 


AO 


00 




4668 


F892 


91 


68 




4669 


F894 


FO 


DA 




4670 


F896 


AO 


00 




4671 


F898 


98 






4672 


F899 


91 


68 




4673 


F89B 


20 


68 


FC 


4674 


F89E 


20 


A8 


FC 


4675 


F8A1 


4C 


DD 


FB 


4676 


F8A4 


38 






4677 


F8A5 


20 


7B 


FB 


4678 


F8A8 


A5 


52 




4679 


F8AA 


85 


55 




4680 


F8AC 


20 


47 


F9 


4681 


F8AF 


A5 


64 




4682 


F8B1 


85 


68 




4683 


F8B3 


18 






4684 


F8B4 


69 


28 




4685 


F8B6 


85 


66 




4686 


F8B8 


A5 


65 




4687 


F8BA 


85 


69 




4688 


F8BC 


69 


00 




4689 


F8BE 


85 


67 




4690 


F8C0 


A6 


54 




4691 


F8C2 


EO 


17 




4692 


F8C4 


FO 


08 




4693 


F8C6 


20 


4E 


FB 
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STA 

PLA 

JMP 

INSCH3: JSR 

INSCH6: DEC 

BMI 

DEC 

BNE 

INSCH5: JMP 



DELCHR: JSR 
DELCHl: JSR 
LDA 
STA 
LDA 
STA 
LDA 
PHA 
JSR 
PLA 
CMP 
BCS 
LDA 
CMP 
BCS 
JSR 
LDY 
STA 
BEQ 
DELCH2: LDY 
TYA 
STA 
JSR 
JSR 
JMP 
INSLIN: SEC 
INSLIA: JSR 
LDA 
STA 
JSR 
LDA 
STA 
CLC 
ADC 
STA 
LDA 
STA 
ADC 
STA 
LDX 
CPX 
BEQ 
INSLIl: JSR 



INSDAT 

INSCH4 
PLACRS 
SCRFLG 
INSCH5 
ROWCRS 
INSCH6 
DOLCOL 



PHACRS 

CONVRT 

ADRESS 

SAVADR 

ADRESS+1 

SAVADR+1 

LOOCOL 

INCRSB 

LOGCOL 

DELCH2 

ROWCRS 

BOTSCR 

DELCH2 

GETPLT 

#0 

( SAVADR ) , Y 

DELCHl 

#0 

( SAVADR ) , Y 
DELTIA 
PLACRS 
DOLCOL 

EXTEND 
LMARGN 
COLORS 
CONVRT 
ADRESS 
FRMADR 

#40 

TOADR 

ADRESS+1 

FRMADR+1 

#0 

TO ADR +1 

ROWCRS 

#23 

INSLI2 

MOVLIN 



IF SCROLL OCCURRED 

MOVE CURSOR UP 

(UNCOND) CONTINUE UNTIL SCRFLG IS MINUS 

COLVERT ROW AND COL TO LOGCOL AND RETURN 



/GET DATA TO THE RIGHT OF THE CURSOR 
; SAVE ADRESS TO KNOW WHERE TO PUT DATA 

;PUT CURSOR OVER NEXT CHARACTER 

i TEST NEW LOGCOL AGAINST OLD LOGCOL 
i IF OLD. GE. NEW THEN QUIT 
; IS ROW OFF SCREEN? 

; YES. SO QUIT 

;GET DATA UNDER CURSOR 

;PUT IT IN PREVIOUS POSITION 
;AND LOOP (UNCONDITIONAL) 



/•CLEAR THE LAST POSITION 
i TRY TO DELETE A LINE 

AND RETURN 

NORMAL INSLIN PUTS "1" INTO BIT MAP 

ENTRY POINT FOR C=0 

DO CARRIAGE RETURN (NO LF> 

; GET ADDRESS 

/SET UP T0=40+FR0M (FROM = CURSOR) 



i SET UP LOOP COUNTER 



ERR LINE ADDR Bl B2 B3 B4 
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4694 


F8C9 


E8 






4695 


F8CA 


EO 


17 




4696 


F8CC 


DO 


F8 




4697 


F8CE 


20 


9B 


FB 


4698 


F8D1 


4C 


DD 


FB 


4699 


F8D4 


20 


DD 


FB 


4700 


F8D7 


A4 


51 




4701 


F8D9 


84 


54 




4702 


F8DB 


A4 


54 




4703 


F8DD 


98 






4704 


F8DE 


38 






4705 


F8DF 


20 


23 


FB 


4706 


F8E2 


08 






4707 


F8E3 


98 






4708 


F8E4 


18 






4709 


F8E5 


69 


78 




4710 


F8E7 


28 






4711 


F8E8 


20 


04 


FB 


4712 


F8EB 


ce 






4713 


F8EC 


CO 


18 




4714 


F8EE 


DO 


ED 




4715 


F8F0 


AD 


B4 


02 


4716 


F8F3 


09 


01 




4717 


F8F5 


8D 


B4 


02 


4718 


F8F8 


A5 


52 




4719 


F8FA 


85 


55 




4720 


F8FC 


20 


47 


F9 


4721 


F8FF 


20 


B7 


FB 


4722 


F902 


20 


20 


FB 


4723 










4724 


F905 


90 


D4 




4725 


F907 


4C 


DD 


FB 


4726 


F90A 


AO 


20 




4727 


F90C 


20 


D8 


FC 


4728 


F90F 


88 






4729 


F910 


10 


FA 




4730 


F912 


60 







INSLI2: 

DELL IN: 
DELL I A: 

DELLIB: 
DELLIl: 



DELL 12: 



; IS IT 



BELL: 
BELLI: 



INX 

CPX 

BNE 

JSR 

JMP 

JSR 

LDY 

STY 

LDY 

TYA 

SEC 

JSR 

PHP 

TYA 

CLC 

ADC 

PLP 

JSR 

INY 

CPY 

BNE 

LDA 

ORA 

STA 

LDA 

STA 

JSR 

JSR 

JSR 

A NEW 

BCC 

JMP 

LDY 

JSR 

DEY 

BPL 

RTS 



#23 

INSLIl 

CLRLIN 

DOLCOL 

DOLCOL 

HOLDl 

RQWCRS 

ROWCRS 



L02GET 



#120 

BITPUT 

#24 
DELLIl 
LOOMAP+2 
#1 

LOGMAP-t-2 
LMARGN 
COLCRS 
CONVRT 
SCROLl 
LOGGET 
LOG LINE? 
DELLIB 
DOLCOL 
#*20 
CLICK 



CLEAR CURRENT LINE 

COLVERT ROW AND COL TO LOGCOL AND RETURN 

GET BEGINNING OF LOG LINE (HOLDl) 

SQUEEZE BIT MAP 

PUT CURSOR THERE 



; GET NEXT BIT 



i WRITE IT OVER PRESENT BIT 



;LOOP 

i SET LSB 



; DELETE LINE OF DATA USING PART OF SCROLL 
; CR NO LF 



i TEST NEXT LINE FOR CONTINUATION 

; NO SO DELETE ANOTHER 

; YES SO DOLCOL AND RETURN 



BELLI 



ERR LINE 


ADDR 


Bl 


B2 B3 


4731 








4732 








4733 








4734 








4735 








4736 








4737 








4738 








4739 








4740 


F913 


A9 


02 


4741 


F915 


DO 


OA 


4742 








4743 








4744 








4745 


F917 


A4 


4C 


4746 


F919 


30 


2B 


4747 


F91B 


AO 


00 


4748 


F91D 


91 


64 


4749 








4750 








4751 


F91F 


A9 


01 


4752 


F921 


8D 


9E 02 


4753 


F924 


A5 


4C 


4754 


F926 


30 


IE 


4755 


F928 


A5 


64 


4756 


F92A 


38 




4757 


F92B 


ED 


9E 02 


4758 


F92E 


85 


64 


4759 


F930 


BO 


02 


4760 


F932 


C6 


65 


4761 


F934 


A5 


OF 


4762 


F936 


C5 


65 


4763 


F938 


90 


OC 


4764 


F93A 


DO 


06 


4765 


F93C 


A5 


OE 


4766 


F93E 


C5 


64 


4767 


F940 


90 


04 


4768 


F942 


A9 


93 


4769 


F944 


85 


4C 


4770 


F946 


60 




4771 








4772 








4773 








4774 








4775 








4776 


F947 


A5 


54 


4777 


F949 


48 




4778 


F94A 


A5 


55 


4779 


F94C 


48 




4780 


F94D 


A5 


56 


4781 


F94F 


48 




4782 


F950 


20 


F3 FC 


4783 


F953 


A5 


54 


4784 


F955 


85 


66 
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DBDDEC: LDA 
BNE 



#2 
DBSUB 



; (UNCONDITIONAL) 



STORE DATA INDIRECT AND DECREMENT POINTER 
(PLACED HERE TO SAVE JMP DBDEC AFTER STORE) 

STORE: LDY DSTAT i RETURN ON ERROR 

BMI STROK 

LDY #0 

STORE!: STA (ADRESS),Y 

; JMP DBDEC DECREMENT AND RETURN 



DBDEC: 


LDA 


#1 




DBSUB: 


STA 


SUBTMP 






LDA 


DSTAT 


; RETUR 




BMI 


STROK 






LDA 


ADRESS 






SEC 








SBC 


SUBTMP 






STA 


ADRESS 






BCS 


DBSUB 1 






DEC 


ADRESS+1 




DBSUB 1: 


LDA 


APPMHI+1 


; MAKE 




CMP 


ADRESS+1 






BCC 


STROK 


i OK 




BNE 


STRERR 


; ERROR 




LDA 


APPMHI 






CMP 


ADRESS 






BCC 


STROK 




STRERR: 


LDA 


#SCRMEM 


; SHOW 




STA 


DSTAT 




STROK: 


RTS 







; MAKE SURE NOTHING EVER OVERWRITES APPMHI 



; SHOW MEM TOO SMALL FOR SCREEN ERROR 



CONVERT ROW/COLUMN CURSOR INTO REAL ADDRESS (FROM SAVMSC ON UP) 

i SAVE CURSOR 



CONVRT: LDA 


ROWCRS 


PHA 




LDA 


COLORS 


PHA 




LDA 


COLCRS+1 


PHA 




JSR 


PUTMSC 


LDA 


ROWCRS 


STA 


MLTTMP 



i PUT 10*R0WCRS INTO MLTTMP 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


4785 


F957 


A9 


00 




4786 


F959 


85 


67 




4787 


F95B 


A5 


66 




4788 


F95D 


OA 






4789 


F95E 


26 


67 




4790 


F960 


85 


51 




4791 


F962 


A4 


67 




4792 


F964 


8C 


9F 


02 


4793 


F967 


OA 






4794 


F968 


26 


67 




4795 


F96A 


OA 






4796 


F96B 


26 


67 




4797 


F96D 


18 






4798 


F96E 


65 


51 




4799 


F970 


85 


66 




4800 


F972 


A5 


67 




4801 


F974 


6D 


9F 


02 


4802 


F977 


85 


67 




4803 


F979 


A6 


57 




4804 


F97B 


BC 


81 


FE 


4805 


F97E 


88 






4806 


F97F 


30 


07 




4807 


F981 


06 


66 




4808 


F983 


26 


67 




4809 


F985 


4C 


7E 


F9 


4810 


F988 


BC 


A5 


FE 


4811 


F98B 


A5 


55 




4812 


F98D 


A2 


07 




4813 


F98F 


88 






4814 


F990 


30 


OA 




4815 


F992 


CA 






4816 


F993 


46 


56 




4817 


F995 


6A 






4818 


F996 


6E 


Al 


02 


4819 


F999 


4C 


8F 


F9 


4820 


F99C 


C8 






4821 


F99D 


18 






4822 


F99E 


65 


66 




4823 


F9A0 


85 


66 




4824 


F9A2 


90 


02 




4825 


F9A4 


E6 


67 




4826 


F9A6 


38 






4827 


F9A7 


6E 


Al 


02 


4828 


F9AA 


18 






4829 


F9AB 


CA 






4830 


F9AC 


10 


F9 




4831 


F9AE 


AE 


Al 


02 


4832 


F9B1 


A5 


66 




4833 


F9B3 


18 






4834 


F9B4 


65 


64 




4835 


F9B6 


85 


64 




4836 


F9B8 


85 


5E 




4837 


F9BA 


A5 


67 




4838 


F9BC 


65 


65 





DISPLAY HANDLER 

LDA 

STA 

LDA 

ASL 

ROL 

STA 

LDY 

STY 

ASL 

ROL 

ASL 

ROL 

CLC 

ADC 

STA 

LDA 

ADC 

STA 

LDX 

LDY 
CONVRl: DEY 

BMI 

ASL 

ROL 

JMP 
C0NVR2: LDY 

LDA 

LDX 
C0NVR3: DEY 

BMI 

DEX 

LSR 

ROR 

ROR 

JMP 
C0NVR4: I NY 

CLC 

ADC 

STA 

BCC 

INC 
C0NVR5: SEC 
C0NVR6: ROR 

CLC 

DEX 

BPL 

LDX 

LDA 

CLC 

ADC 

STA 

STA 

LDA 

ADC 
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#0 

MLTTMP+i 

MLTTMP 

A 

MLTTMP+i 

HOLDl 

MLTTMP+1 

H0LD2 

A 

MLTTMP+1 

A 

MLTTMP+1 

HOLDl 

MLTTMP 

MLTTMP+1 

H0LD2 

MLTTMP+1 

DINDEX 

DHLINE, X 

C0NVR2 

MLTTMP 

MLTTMP+1 

CONVRl 

DIV2TBi X 

COLCRS 

#7 

C0NVR4 

COLCRS+1 
A 

TMPLBT 
C0NVR3 



MLTTMP 
MLTTMP 
C0NVR5 
MLTTMP+1 

TMPLBT 



C0NVR6 
TMPLBT 
MLTTMP 

ADRESS 

ADRESS 

OLDADR 

MLTTMP+1 

ADRESS+1 



QUICK X8 



(SAVE 2X VALUE) 



; ADD IN 2X 



NOW SHIFT MLTTMP LEFT DHLINE TIMES TO FINIS 

MULTIPLY 

LOOP N TIMES 



;NOW DIVIDE HCRSR TO ACCOUNT FOR PARTIAL BYT 
; * TRICKY * 



; SAVE LOW BITS FOR MASK 

;S0 Y IS ZERO UPON RETURN FROM THIS ROUTINE 

; ADD SHIFTED COLCRS TO MLTTMP 



; * TRICKY * 

; SLIDE A "1" UP AGAINST LOW BITS (CONTINUE T 

AND FINISH SHIFT SO LOW BITS ARE 
RIGHT JUSTIFIED. 

TMPLBT IS NOW THE INDEX INTO DMASKTB 
PREPARE FOR RETURN 



REMEMBER THIS ADDRESS FOR CURSOR 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


4839 


F9BE 


85 


65 




4840 


F9C0 


85 


5F 




4841 


F9C2 


BD 


Bl 


FE 


4842 


F9C5 


8D 


AO 


02 


4843 


F9C8 


85 


6F 




4844 


F9CA 


68 






4845 


F9CB 


85 


56 




4846 


F9CD 


68 






4847 


F9CE 


85 


55 




4848 


F9D0 


68 






4849 


F9D1 


85 


54 




4850 


F9D3 


60 






4851 










4852 










4853 










4854 










4855 


F9D4 


A9 


00 




4856 


F9D6 


FO 


02 




4857 


F9D8 


A9 


9B 




4858 


F9DA 


85 


7D 




4859 


F9DC 


E6 


63 




4860 


F9DE 


E6 


55 




4861 


F9E0 


DO 


02 




4862 


F9E2 


E6 


56 




4863 


F9E4 


A5 


55 




4864 


F9E6 


A6 


57 




4865 


F9E8 


DD 


8D 


FE 


4866 


F9EB 


FO 


OB 




4867 


F9ED 


EO 


00 




4868 


F9EF 


DO 


06 




4869 


F9F1 


C5 


53 




4870 


F9F3 


FO 


02 




4871 


F9F5 


BO 


01 




4872 


F9F7 


60 






4873 


F9F8 


EO 


08 




4874 


F9FA 


90 


04 




4875 


F9FC 


A5 


56 




4876 


F9FE 


FO 


F7 




4877 


FAOO 


A5 


57 




4878 


FA02 


DO 


30 




4879 


FA04 


A5 


63 




4880 


FA06 


C9 


51 




4881 


FA08 


90 


OA 




4882 


FAOA 


A5 


7D 




4883 


FAOC 


FO 


26 




4884 


FAOE 


20 


30 


FA 


4885 


FAll 


4C 


77 


FA 


4886 


FA14 


20 


34 


FA 


4887 


FA17 


A5 


54 




4688 


FA19 


18 






4889 


FAIA 


69 


78 




4890 


FAIC 


20 


25 


FB 


4891 


FAIF 


90 


08 




4892 


FA21 


A5 


7D 





HANDLER — 10-30-78 - 


- DISPLC 


STA 


ADRESS+1 




STA 


QLDADR+l 




LDA 


DMASKT, X 




STA 


DMASK 




STA 


SHFAMT 




PLA 






STA 


COLCRS+1 




PLA 






STA 


COLORS 




PLA 






STA 


ROWCRS 




RTS 
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INCREMENT CURSOR AND DETECT BOTH END OF LINE AND END OF SCREEN 



INCRSB: 

INCRSR 
INCRSC 
INCRSA 



INCRS2: 



INCRS3: 
INC2A: 



DOCRl: 



DOCRIB: 



LDA 
BEQ 
LDA 
STA 
INC 
INC 
BNE 
INC 
LDA 
LDX 
CMP 
BEQ 
CPX 
BNE 
CMP 
BEQ 
BCS 
RTS 
CPX 
BCC 
LDA 
BEQ 
LDA 
BNE 
LDA 
CMP 
BCC 
LDA 
BEQ 
JSR 
JMP 
JSR 
LDA 
CLC 
ADC 
JSR 
BCC 
LDA 



#0 

INCRSC 

#*9B 

INSDAT 

LOGCOL 

COLORS 

INCRS2 

COLCRS+1 

COLORS 

DINDEX 

COLUMN, X 

INC 2 A 

#0 

INCRS3 

RMARGN 

INCRS3 

INC2A 

#8 

DOCRl 

COLCRS+1 

INCRS3 

DINDEX 

DOOR 

LOGCOL 

#81 

DOCRIB 

INSDAT 

DOOR 

DOCRWS 

INCRSl 

DOCR 

ROWCRS 

#120 
BITGET 
DOCRl A 
INSDAT 



; NON-EXTEND ENTRY POINT 

; SPECIAL CASE ELIMINATOR 

; <INSCHR ENTRY POINT) 

; DO HIGH BYTE 

; TEST END OF LINE 

TEST TABLED VALUE FOR ALL SCREEN MODES 

DO CR IF EQUAL 

MODE 0? 

IF NOT, JUST RETURN 

TEST AGAINST RMARGN 

EQUAL IS OK 

IF GREATER THAN, DO CR 

CHECK MODE 

NOT 320X1 SO DO IT 

TEST MSD 

ONLY AT 64 SO DON'T DO IT 

DON'T MESS WITH LOGMAP IF NO MODE ZERO 

; TEST LINE OVERRUN 

; IF LESS THAN 81 IT IS DEFINITELY NOT LINE 3 

ONLY DO LOG LINE OVERFLOW IF INSDAT OO 

LOG LINE OVERFLOW IS SPECIAL CASE 

RETURN 

GET IT OVER WITH 

; TEST LOGICAL LINE BIT MAP 



; DON'T EXTEND IF OVERRUN IS INTO MIDDLE OF L 
; DON'T EXTEND IF INSDAT IS ZERO 



ERR LINE ADDR Bl B2 B3 B4 
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4893 


FA23 


FO 


04 




4894 


FA25 


18 






4895 


FA26 


20 


A5 


F8 


4896 


FA29 


4C 


DD 


FB 


4897 


FA2C 


A9 


00 




4898 


FA2E 


FO 


02 




4899 


FA30 


A9 


9B 




4900 


FA32 


85 


7D 




4901 


FA34 


20 


E4 


FC 


4902 


FA37 


A9 


00 




4903 


FA39 


85 


56 




4904 


FA3B 


E6 


54 




4905 


FA3D 


A6 


57 




4906 


FA3F 


AO 


18 




4907 


FA41 


24 


7B 




4908 


FA43 


10 


05 




4909 


FA45 


AO 


04 




4910 


FA47 


98 






4911 


FA48 


DO 


03 




4912 


FA4A 


BD 


99 


FE 


4913 


FA4D 


C5 


54 




4914 


FA4F 


DO 


26 




4915 


FA51 


8C 


9D 


02 


4916 


FA54 


8A 






4917 


FA55 


DO 


20 




4918 


FA57 


A5 


7D 




4919 


FA59 


FO 


IC 




4920 










4921 


FA5B 


C9 


9B 




4922 


FA5D 


38 






4923 


FA5E 


FO 


01 




4924 


FA60 


18 






4925 


FA61 


20 


AC 


FB 


4926 


FA64 


EE 


BB 


02 


4927 


FA67 


C6 


6C 




4928 


FA69 


CE 


9D 


02 


4929 


FA6C 


AD 


B2 


02 


4930 


FA6F 


38 






4931 


FA70 


10 


EF 




4932 


FA72 


AD 


9D 


02 


4933 


FA75 


85 


54 




4934 


FA77 


4C 


DD 


FB 


4935 










4936 










4937 










4938 










4939 


FA7A 


38 






4940 


FA7B 


B5 


70 




4941 


FA7D 


E5 


74 




4942 


FA7F 


95 


70 




4943 


FA81 


B5 


71 




4944 


FA83 


E5 


75 




4945 


FA85 


95 


71 




4946 


FAS7 


60 







DOCRIA: 
NOSCRL: 

DOCRWS: 
NOSCRl: 
DOCR: 



D0CR2: 



D0CR2A: 
D0CR2B: 



D0CR4B: 



INCRSl 



BEQ 
CLC 
JSR 
JMP 
LDA 
BEQ 
LDA 
STA 
JSR 
LDA 
STA 
INC 
LDX 
LDY 
BIT 
BPL 
LDY 
TYA 
BNE 
LDA 
CMP 
BNE 
STY 
TXA 
BNE 
LDA 
BEQ 
LDA 
CMP 
SEC 
BEQ 
CLC 
JSR 
INC 
DEC 
DEC 
LDA 
SEC 
BPL 
LDA 
STA 
JMP 



DOCRIA 

INSLIA 

DOLCOL 

#0 

NOSCRl 

#*9B 

INSDAT 

COLCR 

#0 

COLCRS+1 

ROWCRS 

DINDEX 

#24 

SWPFLO 

D0CR2A 

#4 

D0CR2B 
NOROWS, X 
ROWCRS 
INCRSl 
H0LD3 

INCRSl 
INSDAT 
INCRSl 
INSDAT 
#*9B 

D0CR4B 

SCROLL 

SCRFLG 

BUFSTR 

HOLDS 

LOGMAP 

D0CR4B 
H0LD3 
ROWCRS 
DOLCOL 



i (INSCHR SPECIAL CASE) 
; INSERT "0" INTO BIT MAP 

CONVERT ROW AND COL TO LOGCOL AND RETURN 

DOCR WITHOUT SCROLL 

(UNCONDITIONAL) 

DOCR WITH SCROLLING (NORMAL MODE) 

; PLACE COLCRS AT LEFT EDGE 



iSET UP SCROLL LOOP COUNTER 
; BRANCH IF NORMAL 



; (UNCONDITIONAL) 
; GET NO OF ROWS 



; DON'T SCROLL IF MODE <> 

i OR IF INSDAT = 

IF INSDAT <> *9B THEN ROLL IN A 
; TO EXTEND BOTTOM LOGICAL LINE 



; LOOP BACK TO HERE IF >1 SCROLLS 
; ROWS MOVE UP SO BUFSTR SHOULD TOO 



FOR PARTIAL LINES, ROLL IN A "1" 

AGAIN IF PARTIAL LOGICAL LINE 

PLACE CURSOR AT NEW LINE NEAR THE BOTTOM 

; COLVERT ROW AND COL TO LOGCOL AND RETURN 



SUBEND: SUBTRACT ENDPT FROM ROWAC OR COLAC. ( X=0 OR 2) 



SUBEND: SEC 
LDA 
SBC 
STA 
LDA 
SBC 
STA 
RTS 



ROWAC. X 

ENDPT 

ROWAC, X 

ROWAC+1, 

ENDPT+1 

ROWAC+1, 



ERR LINE 


ADDR 


Bl 


B2 


B3 


4947 










4948 










4949 










4950 










4951 










4952 










4953 


FA88 


AD 


BF 


02 


4954 


FA8B 


C9 


04 




4955 


FA8D 


FO 


07 




4956 


FA8F 


A5 


57 




4957 


FA91 


FO 


03 




4958 


FA93 


20 


FC 


F3 


4959 


FA96 


A9 


27 




4960 


FA98 


C5 


53 




4961 


FA9A 


BO 


02 




4962 


FA9C 


85 


53 




4963 


FA9E 


A6 


57 




4964 


FAAO 


BD 


99 


FE 


4965 


FAA3 


•C5 


54 




4966 


FAA5 


90 


2A 




4967 


FAA7 


FO 


28 




4968 


FAA9 


EO 


08 




4969 


FAAB 


DO 


OA 




4970 


FAAD 


A5 


56 




4971 


FAAF 


FO 


13 




4972 


FABl 


C9 


01 




4973 


FAB3 


DO 


IC 




4974 


FAB5 


FO 


04 




4975 


FAB7 


A5 


56 




4976 


FAB9 


DO 


16 




4977 


FABB 


BD 


8D 


FE 


4978 


FABE 


C5 


55 




4979 


FACO 


90 


OF 




4980 


FAC2 


FO 


OD 




4981 


FAC4 


A9 


01 




4982 


FAC6 


85 


4C 




4983 


FAC8 


A9 


80 




4984 


FACA 


A6 


11 




4985 


FACC 


85 


11 




4986 


FACE 


FO 


06 




4987 


FADO 


60 






4988 


FADl 


20 


D6 


F7 


4989 


FAD4 


A9 


8D 




4990 


FAD6 


85 


4C 




4991 


FAD8 


68 






4992 


FAD9 


68 






4993 


FADA 


A5 


7B 




4994 


FADC 


10 


03 




4995 


FADE 


20 


B9 


FC 


4996 


FAEl 


4C 


34 


F6 


4997 










4998 










4999 










5000 
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RANGE: DO CURSOR RANGE TEST. IF ERROR, POP STACK TWICE AND JMP RETURN 
(ERANGE IS EDITOR ENTRY POINT AND TEST IF EDITOR IS OPEN. 
IF IT ISNT IT OPENS THE EDITOR AND CONTINUES) 



ERANGE: 



RANGE: 



RANGE3: 



RANOEl: 
RANGE2: 

RNGQK: 



RNOERR: 

RNGER2: 
RNGERl: 



RETUR3: 



LDA 
CMP 
BEQ 
LDA 
BEQ 
JSR 
LDA 
CMP 
BCS 
STA 
LDX 
LDA 
CMP 
BCC 
BEQ 
CPX 
BNE 
LDA 
BEQ 
CMP 
BNE 
BEQ 
LDA 
BNE 
LDA 
CMP 
BCC 
BEQ 
LDA 
STA 
LDA 
LDX 
STA 
BEQ 
RTS 
JSR 
LDA 
STA 
PLA 
PLA 
LDA 
BPL 
JSR 
JMP 



BOTSCR 

#4 

RANGE 

DINDEX 

RANGE 

EOPEN 

#39 

RMARGN 

RANGE3 

RMARGN 

DINDEX 

NOROWS, X 

ROWCRS 

RNGERR 

RNOERR 

#8 

RANGE 1 

COLCRS+1 

RNGOK 

#1 

RNOERR 

RANGE2 

COLCRS+1 

RNGERR 

COLUMN, X 

COLORS 

RNGERR 

RNGERR 

#SUCCES 

DSTAT 

#BRKABT 

BRKKEY 

BRKKEY 

RNGER2 

HOME 

#CRSROR 

DSTAT 



SWPFLG 
RETUR3 
SWAP A 
RETURl 



IF BQTSCR=4 

THEN IT IS IN MIXED MODE AND OK 

IF MODE = 

THEN IT IS IN EDITOR MODE AND OK 

IF NOT, OPEN EDITOR 

***** RANGE CHECK RMARGN ***** SET UP AC 

***** RANGE CHECK RMARGN ***** COMPARE 

***** RANGE CHECK RMARGN ***** BRANCH GE 

***** RANGE CHECK RMARGN ***** BAD SO STORE 

CHECK ROWS 

(ERROR IF TABLE. GE. ROWCRS) 

CHECK FOR 320X1 
SPECIAL CASE IT 

IF HIGH BYTE IS 0, COL IS OK 

IF >1, BAD 

IF 1, GO CHECK LOW BYTE 

FOR OTHERS, NON-ZERO HIGH BYTE IS BAD 

CHECK LOW BYTE 



; SET STATUS OK 

; PREPARE BREAK ABORT STATUS 

; CHECK BREAK KEY FLAG 

; 'CLEAR' BREAK 

; IF BREAK, QUIT IMMEDIATELY AND RETURN TO CI 

iON RANGE ERROR, BRING CURSOR BACK 
i SHOW CURSOR OVERRANGE ERROR 

; RESTORE STACK (THIS ROUTINE IS ALWAYS 1 LEV 
;AWAY FROM RETURN TO CIO) 
; IF SWAPPED, SWAP BACK 

i AND DONT DO RETURl 
; RETURN TO CIO 



OFFCRS: RESTORE OLD DATA UNDER CURSOR SO IT CAN BE MOVED 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


5001 










5002 


FAE4 


AO 


00 




5003 


FAE6 


A5 


5D 




5004 


FAE8 


91 


5E 




5005 


FAEA 


60 






5006 










5007 










5008 










5009 










5010 










5011 










5012 










5013 










5014 










5015 










5016 










5017 










5018 










5019 


FAEB 


48 






5020 


FAEC 


29 


07 




5021 


FAEE 


AA 






5022 


FAEF 


BD 


B9 


FE 


5023 


FAF2 


85 


6E 




5024 


FAF4 


68 






5025 


FAF5 


4A 






5026 


FAF6 


4A 






5027 


FAF7 


4A 






5028 


FAF8 


AA 






5029 


FAF9 


60 






5030 










5031 










5032 


FAFA 


2E 


B4 


02 


5033 


FAFD 


2E 


B3 


02 


5034 


FBOO 


2E 


B2 


02 


5035 


FB03 


60 






5036 










5037 










5038 


FB04 


90 


OC 




5039 










5040 


FB06 


20 


EB 


FA 


5041 


FB09 


BD 


A3 


02 


5042 


FBOC 


05 


6E 




5043 


FBOE 


9D 


A3 


02 


5044 


FBll 


60 






5045 










5046 


FB12 


20 


EB 


FA 


5047 


FB15 


A5 


6E 




5048 


FB17 


49 


FF 




5049 


FB19 


3D 


A3 


02 


5050 


FEIC 


9D 


A3 


02 


5051 


FBIF 


60 






5052 










5053 


FB20 


A5 


54 




5054 


FB22 


18 
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OFFCRS: 



LDY 
LDA 
STA 
RTS 



#0 

OLDCHR 
(OLDADR). Y 



BITMAP ROUTINES: 



BITCON 
BITPUT 
BITROL 
BITSET 
BITCLR 
BITGET 
LOGGET 



PUT MASK IN BITMSK AND INDEX IN X 

PUT CARRY INTO BITMAP 

ROL CARRY INTO BOTTOM OF BITMAP (SCROLL) 

SET PROPER BIT 

CLEAR PROPER BIT 

RETURN CARRY SET IF BIT IS THERE 

DO BITGET FOR LOGMAP INSTEAD OF TABMAP 



BITCON: PHA 
AND 
TAX 
LDA 
STA 
PLA 
LSR 
LSR 
LSR 
TAX 
RTS 



BITROL: ROL 
ROL 
ROL 
RTS 



#7 

MASKTBi X 
BITMSK 

A 
A 
A 



LOGMAP+2 
LOGMAP+1 
LOGMAP 



; GET MASK 



; PROCESS INDEX 



BITPUT: BCC BITCLR ; AND RETURN 

i OTHERWISE FALL THROUGH TO BITSET AND RETURN 

BITSET: JSR BITCON 

LDA TABMAP/ X 

OR A BITMSK 

STA TABMAP/ X 

RTS 



BITCLR: 


JSR 


BITCON 






LDA 


BITMSK 






EOR 


#*FF 






AND 


TABMAP, 


X 




STA 


TABMAP/ 


X 




RTS 






/■ 
LOGGET: 


LDA 


ROWCRS 




LOIGET: 


CLC 







ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


5055 


FB23 


69 


78 




5056 


FB25 


20 


EB 


FA 


5057 


FB28 


18 






5058 


FB29 


BD 


A3 


02 


5059 


FB2C 


25 


6E 




5060 


FB2E 


FO 


01 




5061 


FB30 


38 






5062 


FB31 


60 






5063 










5064 










5065 










5066 










5067 










5068 










5069 


FB32 


AD 


FA 


02 


5070 


FB35 


A4 


57 




5071 


FB37 


CO 


03 




5072 


FB39 


BO 


OF 




5073 


FB3B 


2A 






5074 


FB3C 


2A 






5075 


FB3D 


2A 






5076 


FB3E 


2A 






5077 


FB3F 


29 


03 




5078 


FB41 


AA 






5079 


FB42 


AD 


FA 


02 


5080 


FB45 


29 


9F 




5081 


FB47 


ID 


FA 


FE 


5082 


FB4A 


8D 


FB 


02 


5083 


FB4D 


60 






5084 










5085 










5086 










5087 










5088 










5089 










5090 










5091 


FB4E 


A9 


02 




5092 


FB50 


85 


65 




5093 


FB52 


A9 


47 




5094 


FB54 


85 


64 




5095 


FB56 


AO 


27 




5096 


FB58 


Bl 


66 




5097 


FB5A 


85 


50 




5098 


FB5C 


Bl 


68 




5099 


FB5E 


91 


66 




5100 


FB60 


A5 


50 




5101 


FB62 


91 


64 




5102 


FB64 


88 






5103 


FB65 


10 


Fl 




5104 


FB67 


A5 


65 




5105 


FB69 


85 


69 




5106 


FB6B 


A5 


64 




5107 


FB6D 


85 


68 




5108 


FB6F 


18 







DISPLA 


Y HANDLER — 10-30-78 — 


- DISPLC 


L02GET: 


ADC 


#120 




BITOET: 


JSR 
CLC 


B I ICON 






LDA 


TABMAP, X 






AND 


BITMSK 






BEQ 


BITGEl 






SEC 






BITGEl: 


RTS 
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INATAC: INTERNAL ( CHAR ) TO ATASC 1 1 (ATACHR ) CONVERSION 

i IF GRAPHICS MODES 

i THEN DON'T CHANGE CHAR 



INATAC: 


LDA 


CHAR 




LDY 


DINDEX 




CPY 


#3 




BCS 


INATAl 




ROL 


A 




ROL 


A 




ROL 


A 




ROL 


A 




AND 


#3 




TAX 






LDA 


CHAR 




AND 


#*9F 




ORA 


INTATA, X 


INATAl: 


STA 
RTS 


ATACHR 



MOVLIN: MOVE 40 BYTES AT FRMADR TO TOADR SAVING OLD TOADR 
DATA IN THE LINBUF. THEN MAKE NEXT FRMADR 
BE AT LINBUF FOR NEXT TRANSFER Z'. T0ADR=T0ADR+40 



MOVLIN: 


LDA 


#LINBUF/25 




STA 


ADRESS+1 




LDA 


#LINBUF. AN 




STA 


ADRESS 




LDY 


#39 


MOVLIl: 


LDA 


( TOADR > , Y 




STA 


TMPCHR 




LDA 


( FRMADR > , Y 




STA 


< TOADR ) , Y 




LDA 


TMPCHR 




STA 


(ADRESS), Y 




DEY 






BPL 


MOVLIl 




LDA 


ADRESS+1 




STA 


FRMADR+1 




LDA 


ADRESS 




STA 


FRMADR 




CLC 





i SAVE TO DATA 
; STORE DATA 



SET UP FRMADR=LAST LINE 



ADD 40 TO TOADR 



ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


5109 


FB70 


A5 


66 




5110 


FB72 


69 


28 




5111 


FB74 


85 


66 




5112 


FB76 


90 


02 




5113 


FB78 


E6 


67 




5114 


FB7A 


60 






5115 










5116 










5117 










5118 










5119 










5120 


FB7B 


08 






5121 


FB7C 


AO 


17 




5122 


FB7E 


98 






5123 


FB7F 


20 


22 


FB 


5124 


FB82 


08 






5125 


FB83 


98 






5126 


FB84 


18 






5127 


FB85 


69 


79 




5128 


FB87 


28 






5129 


FB88 


20 


04 


FB 


5130 


FB8B 


88 






5131 


FB8C 


30 


04 




5132 


FB8E 


C4 


54 




5133 


FB90 


BO 


EC 




5134 


FB92 


A5 


54 




5135 


FB94 


18 






5136 


FB95 


69 


78 




5137 


FB97 


28 






5138 


FB98 


4C 


04 


FB 


5139 










5140 










5141 










5142 










5143 










5144 


FB9B 


A5 


52 




5145 


FB9D 


85 


55 




5146 


FB9F 


20 


47 


F9 


5147 


FBA2 


AO 


27 




5148 


FBA4 


A9 


00 




5149 


FBA6 


91 


64 




5150 


FBA8 


88 






5151 


FBA9 


10 


FB 




5152 


FBAB 


60 






5153 










5154 










5155 










5156 










5157 










5158 










5159 


FBAC 


20 


FA 


FA 


5160 


FBAF 


A5 


58 




5161 


FBBl 


85 


64 




5162 


FBB3 


A5 


59 
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- DISPLC 


LDA 


TOADR 




ADC 


#40 




STA 


TOADR 




BCC 


M0VLI2 




INC 


TOADR+1 




M0VLI2: RTS 
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EXTEND BIT MAP FROM ROWCRS (EXTEND LOGICAL LINE 
i SAVE CARRY 



; EXTEND: EXTEND BIT M 


EXTEND: 


PHP 






LDY 


#23 


EX TEN 1: 


TYA 






JSR 


LOIGET 




PHP 






TYA 






CLC 






ADC 


#121 




PLP 






JSR 


BITPUT 


EXTEN3: 


DEY 






BMI 


EXTEN4 




CPY 


ROWCRS 




BCS 


EXTENl 


EXTEN4: 


LDA 
CLC 


ROWCRS 




ADC 


#120 




PLP 






JMP 


BITPUT 



STORE NEW LINE'S BIT AND RETURN 



CLRLIN: CLEAR LINE CURSOR IS ON 



CLRLIN: 


LDA 


LMARGN 




STA 


COLORS 




JSR 


CONVRT 




LDY 


#39 




LDA 


#0 


CLRLIl: 


STA 
DEY 


(ADRESS) 




BPL 


CLRLIl 




RTS 





SCROLL: SCROLL SCREEN 



SCROLL: JSR 
LDA 
STA 
LDA 



BITROL 
SAVMSC 
ADRESS 
SAVMSC +1 



; ROLL IN CARRY 

; SET UP WORKING REGISTERS 



LINE 


ADDR 


Bl 


B2 B3 B4 


5163 


FBB5 


85 


65 


5164 


FBB7 


AO 


28 


5165 


FBB9 


Bl 


64 


5166 


FBBB 


A6 


6A 


5167 


FBBD 


CA 




5168 


FBBE 


E4 


65 


5169 


FBCO 


DO 


08 


5170 


FBC2 


A2 


D7 


5171 


FBC4 


E4 


64 


5172 


FBC6 


BO 


02 


5173 


FBC8 


A9 


00 


5174 


FBCA 


AO 


00 


5175 


FBCC 


91 


64 


5176 


FBCE 


E6 


64 


5177 


FBDO 


DO 


E5 


5178 


FBD2 


E6 


65 


5179 


FBD4 


A5 


65 


5180 


FBD6 


C5 


6A 


5181 


FBD8 


DO 


DD 


5182 


FBDA 


4C 


DD FB 


5183 








5184 








5185 








5186 








5187 


FBDD 


A9 


00 


5188 


FBDF 


85 


63 


5189 


FBEl 


A5 


54 


5190 


FBE3 


85 


51 


5191 


FBE5 


A5 


51 


5192 


FBE7 


20 


22 FB 


5193 


FBEA 


BO 


OC 


5194 


FBEC 


A5 


63 


5195 


FBEE 


18 




5196 


FBEF 


69 


28 


5197 


FBFl 


85 


63 


5198 


FBF3 


C6 


51 


5199 


FBF5 


4C 


E5 FB 


5200 


FBF8 


18 




5201 


FBF9 


A5 


63 


5202 


FBFB 


65 


55 


5203 


FBFD 


85 


63 


5204 


FBFF 


60 




5205 








5206 








5207 








5208 








5209 








5210 








5211 


FCOO 


20 


9D FC 


5212 


FC03 


A5 


63 


5213 


FC05 


48 




5214 


FC06 


A5 


6C 


5215 


FC08 


85 


54 


5216 


FCOA 


A5 


6D 
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STA 


ADRESS+1 




SCROLl: 


LDY 


#40 


iLOOP 




LDA 


(ADRESS), Y 






LDX 


RAMTOP 


;TEST FOR LA 




DEX 








CPX 


ADRESS+1 






BNE 


SCR0L2 






LDX 


#*D7 






CPX 


ADRESS 






BCS 


SCR0L2 






LDA 


#0 


i YES SO STOR 


SCR0L2: 


LDY 


#0 






STA 


< ADRESS ) , Y 






INC 


ADRESS 






BNE 


SCROLl 






INC 


ADRESS+1 






LDA 


ADRESS+1 






CMP 


RAMTOP 






BNE 


SCROLl 






JMP 


DOLCOL 


;AND RETURN 



PAGE 115 



ZERO DATA FOR THIS ENTIRE LINE 



DOLCOL: DO LOGICAL COLUMN FROM BITMAP AND COLORS 

; START WITH ZERO 



;ADD IN ROW COMPONENT 

i FOUND BEGINNING OF LINE 
; ADD 40 AND LOOK BACK ONE 



; UP ONE LINE 
; ADD IN COLORS 



DOLCOL: 


LDA 


#0 




STA 


LOGCOL 




LDA 


ROWCRS 




STA 


HOLDl 


DOLCOl: 


LDA 


HOLDl 




JSR 


LOIGET 




BCS 


D0LC02 




LDA 


LOGCOL 




CLC 






ADC 


#40 




STA 


LOGCOL 




DEC 


HOLDl 




JMP 


DOLCOl 


D0LC02: 


CLC 






LDA 


LOGCOL 




ADC 


COLORS 




STA 


LOGCOL 




RTS 





DOBUFC : 



COMPUTE BUFFER COUNT AS THE NUMBER OF BYTES FROM 

BUFSTR TO END OF LOGICAL LINE WITH TRAILING SPACES REMOVED 



DOBUFC: 



JSR 
LDA 
PHA 
LDA 
STA 
LDA 



PHACRS 
LOGCOL 

BUFSTR 
ROWCRS 
BUFSTR+1 



; START 



ERR LINE 


ADDR 


Bl 


B2 B3 


5217 


FCOC 


85 


55 


5218 


FCOE 


A9 


01 


5219 


FCIO 


85 


6B 


5220 


FC12 


A2 


17 


5221 


FC14 


A5 


7B 


5222 


FC16 


10 


02 


5223 


FC18 


A2 


03 


5224 


FCIA 


E4 


54 


5225 


FCIC 


DO 


OB 


5226 


FCIE 


A5 


55 


5227 


FC20 


C5 


53 


5228 


FC22 


DO 


05 


5229 


FC24 


E6 


6B 


5230 


FC26 


4C 


39 FC 


5231 


FC29 


20 


D4 F9 


5232 


FC2C 


E6 


6B 


5233 


FC2E 


A5 


63 


5234 


FC30 


C5 


52 


5235 


FC32 


DO 


DE 


5236 


FC34 


C6 


54 


5237 


Fe36 


20 


99 F7 


5238 


FC39 


20 


A2 F5 


5239 


FC3C 


DO 


17 


5240 


FC3E 


C6 


6B 


5241 


FC40 


A5 


63 


5242 


FC42 


C5 


52 


5243 


FC44 


FO 


OF 


5244 


FC46 


20 


99 F7 


5245 


FC49 


A5 


55 


5246 


FC4B 


C5 


53 


5247 


FC4D 


DO 


02 


5248 


FC4F 


C6 


54 


5249 


FC51 


A5 


6B 


5250 


FC53 


DO 


E4 


5251 


FC55 


68 




5252 


FC56 


85 


63 


5253 


FC58 


20 


A8 FC 


5254 


FC5B 


60 




5255 








5256 








5257 








5258 








5259 








5260 








5261 


FC5C 


20 


DD FB 


5262 


FC5F 


A5 


51 


5263 


FC61 


85 


6C 


5264 


FC63 


A5 


52 


5265 


FC65 


85 


6D 


5266 


FC67 


60 




5267 








5268 








5269 








5270 
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STA 


COLORS 




LDA 


#1 




STA 


BUFCNT 


DOBUFl: 


LDX 


#23 




LDA 


SWPFLO 




BPL 


DOBl 




LDX 


#3 


DOB 1 : 


CPX 


ROWCRS 




BNE 


DOBUIA 




LDA 


COLCRS 




CMP 


RMARON 




BNE 


DOBUIA 




INC 


BUFCNT 




JMP 


D0BUF2 


DOBUIA: 


JSR 


INCRSB 




INC 


BUFCNT 




LDA 


LOGCOL 




CMP 


LMARGN 




BNE 


DOBUFl 




DEC 


ROWCRS 




JSR 


CRSRLF 


D0BUF2: 


JSR 


GETPLT 




BNE 


D0BUF4 




DEC 


BUFCNT 




LDA 


LOGCOL 




CMP 


LMARGN 




BEQ 


D0BUF4 




JSR 


CRSRLF 




LDA 


COLCRS 




CMP 


RMARGN 




BNE 


D0BUF3 




DEC 


ROWCRS 


D0BUF3: 


LDA 


BUFCNT 




BNE 


D0BUF2 


D0BUF4: 


PLA 






STA 


LOGCOL 




JSR 


PLACRS 




RTS 





; NORMAL 

; IF SWAPPED, ROW 3 IS THE LAST LINE ON SCREE 



TEST IF CRSR IS AT LAST SCREEN POSITION 



YES, SO FAKE INCRSR TO AVOID SCROLLING 



NOT YET EQL 

BACK UP ONE INCRSR 

TEST CURRENT COLUMN FOR NON-ZERO DATA 

QUIT IF NON-ZERO 

DECREMENT COUNTER 

BEGINNING OF LOGICAL LINE YET? 

YES, SO QUIT 

BACK UP CURSOR 

IF LOGCOL=RMARGN, GO UP 1 ROW 



LOOP UNLESS BUFCNT JUST WENT TO ZERO 



STRBEG: MOVE BUFSTR TO BEGINNING OF LOGICAL LINE. 

; USE DOLCOL TO POINT HOLDl AT BOL 



STRBEG: 


JSR 


DOLCOL 




LDA 


HOLDl 




STA 


BUFSTR 




LDA 


LMARGN 




STA 


BUFSTR-J-l 




RTS 





ERR LINE 


ADDR 


Bl 


B2 


B3 


5271 










5272 










5273 










5274 


FC68 


A5 


63 




5275 


FC6A 


C5 


52 




5276 


FC6C 


DO 


02 




5277 


FC6E 


C6 


54 




5278 


FC70 


20 


DD 


FB 


5279 


FC73 


A5 


63 




5280 


FC75 


C5 


52 




5281 


FC77 


FO 


13 




5282 


FC79 


20 


47 


F9 


5283 


FC7C 


A5 


53 




5284 


FC7E 


38 






5285 


FC7F 


E5 


52 




5286 


FC81 


A8 






5287 


FC82 


Bl 


64 




5288 


FCS4 


DO 


06 




5289 


FC86 


88 






5290 


FC87 


10 


F9 




5291 


FC89 


4C 


DB 


F8 


5292 


FCSC 


60 






5293 










5294 










5295 










5296 










5297 










5298 


FC8D 


A2 


2D 




5299 


FCSF 


BD 


C6 


FE 


5300 


FC92 


CD 


FB 


02 


5301 


FC95 


FO 


05 




5302 


FC97 


CA 






5303 


FC78 


CA 






5304 


FC99 


CA 






5305 


FC9A 


10 


F3 




5306 


FC9C 


60 






5307 










5308 










5309 










5310 










5311 










5312 


FC9D 


A2 


02 




5313 


FC9F 


B5 


54 




5314 


FCAl 


9D 


B8 


02 


5315 


FCA4 


CA 






5316 


FCA5 


10 


F8 




5317 


FCA7 


60 






5318 










5319 










5320 










5321 










5322 


FCA8 


A2 


02 




5323 


FCAA 


BD 


B8 


02 


5324 


FCAD 


95 


54 
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IF LOGCOLOLMARGN 
THEN DONT MOVE UP ONE 
LINE BEFORE TESTING DELTIM 



; TEST FOR EXTENSION 

;N0 

iSET UP COUNT 

; FOUND A NON-0 SO QUIT AND RETURN 
i DELETE A LINE AND RETURN 



TSTCTL: SEARCH CNTRLS TABLE TO SEE IF ATACHR IS A CNTL CHAR 

; PREPARE TO SEARCH TABLE 



i DELTIM; TIME 


TO DELETE A 


DELTIA: 


LDA 


LOGCOL 




CMP 


LMARGN 




BNE 


DELTIB 




DEC 


ROWCRS 


DELTIB: 


JSR 


DOLCOL 


DELTIM: 


LDA 


LOGCOL 




CMP 


LMARGN 




BEQ 


DELTI3 




JSR 


CONVRT 




LDA 


RMARGN 




SEC 






SBC 


LMARGN 




TAY 




DELTIl: 


LDA 


( ADRESS > , Y 




BNE 


DELTI3 




DEY 






BPL 


DELTIl 


DELTI2: 


JMP 


DELL IB 


DELTI3: 


RTS 





TSTCTL: LDX 
TSTCTl: LDA 
CMP 
BEQ 
DEX 
DEX 
DEX 
BPL 
TSTCT2: RTS 



#45 
CNTRLS, X 
ATACHR 
TSTCT2 



TSTCTl 



PUSH ROWCRS, COLORS AND COLCRS+1 



PHACRS: LDX 
PHACRl: LDA 
STA 
DEX 
BPL 
RTS 



#2 

ROWCRS, X 
TMPROW, X 

PHACRl 



PULL COLCRS+1, COLORS AND ROWCRS 



PLACRS: LDX 

PLACRl: LDA 

STA 



#2 

TMPROW, X 
ROWCRS, X 



LINE 


ADDR 


Bl 


B2 


B3 B4 


5325 


FCAF 


CA 






5326 


FCBO 


10 


F8 




5327 


FCB2 


60 






5328 










5329 










5330 










5331 










5332 










5333 


FCB3 


20 


B9 


FC 


5334 


FCB6 


4C 


34 


F6 


5335 


FCB9 


AD 


BF 


02 


5336 


FCBC 


C9 


18 




5337 


FCBE 


FO 


17 




5338 


FCCO 


A2 


OB 




5339 


FCC2 


B5 


54 




5340 


FCC4 


48 






5341 


FCC5 


BD 


90 


02 


5342 


FCC8 


95 


54 




5343 


FCCA 


68 






5344 


FCCB 


9D 


90 


02 


5345 


FCCE 


CA 






5346 


FCCF 


10 


Fl 




5347 


FCDl 


A5 


7B 




5348 


FCD3 


49 


FF 




5349 


FCD5 


85 


7B 




5350 


FCD7 


60 






5351 










5352 










5353 










5354 










5355 


FCD8 


A2 


7F 




5356 


FCDA 


8E 


IF 


DO 


5357 


FCDD 


8E 


OA 


D4 


5358 


FCEO 


CA 






5359 


FCEl 


10 


F7 




5360 


FCE3 


60 






5361 










5362 










5363 










5364 










5365 


FCE4 


A9 


00 




5366 


FCE6 


A6 


7B 




5367 


FCE8 


DO 


04 




5368 


FCEA 


A6 


57 




5369 


FCEC 


DO 


02 




5370 


FCEE 


A5 


52 




5371 


FCFO 


85 


55 




5372 


FCF2 


60 






5373 










5374 










5375 










5376 










5377 


FCF3 


A5 


58 




5378 


FCF5 


85 


64 
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PLACRl 



SWAP: IF MIXED MODE, SWAP TEXT CURSORS WITH REGULAR CURSORS 

;THIS ENTRY POINT DOES RETURl 



SWAP: 


JSR 


SWAPA 






JMP 


RETURl 




SWAP A: 


LDA 


BOTSCR 






CMP 


#24 






BEQ 


SWAP3 






LDX 


#11 




SWAPl: 


LDA 
PHA 


ROWCRS. 


X 




LDA 


TXTROW, 


X 




STA 


ROWCRS, 


X 




PLA 








STA 


TXTROW, 


X 




DEX 








BPL 


SWAPl 






LDA 


SWPFLG 






EOR 


#*FF 






STA 


SWPFLG 




SWAPS: 


RTS 







CLICK: MAKE CLICK THROUGH KEYBOARD SPEAKER 



CLICK: 


LDX 


#*7F 


CLICKl: 


STX 


CONSOL 




STX 


WSYNC 




DEX 






BPL 


CLICKl 




RTS 





COLOR: PUTS EITHER OR LMARGN INTO COLORS BASED ON MODE AND SWPFLG 



COLOR: 


LDA 


#0 




LDX 


SWPFLG 




BNE 


COLOR 1 




LDX 


DINDEX 




BNE 


C0LCR2 


COLOR 1: 


LDA 


LMARGN 


C0LCR2: 


STA 
RTS 


COLCRS 



PUTMSC: PUT SAVMSC INTO ADRESS 



PUTMSC : LDA 
STA 



SAVMSC 
ADRESS 



; SET UP ADDRESS 



ERR LINE 


ADDR 


Bl B2 B3 B4 


5379 


FCF7 


A5 59 


5380 


FCF9 


85 65 


5381 


FCFB 


60 


5382 
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LDA SAVMSC+i 
STA ADRESS+1 
RTS 



LINE 


ADDR 


Bl 


B2 


5383 








5384 








5385 








5386 








5387 








5388 


FCFC 


A2 


00 


5389 


FCFE 


A5 


22 


5390 


FDOO 


C9 


11 


5391 


FD02 


FO 


08 


5392 


FD04 


C9 


12 


5393 


FD06 


FO 


03 


5394 


FD08 


AO 


84 


5395 


FDOA 


60 




5396 


FDOB 


E8 




5397 


FDOC 


8E 


B7 


5398 


FDOF 


A5 


54 


5399 


FDll 


85 


60 


5400 


FD13 


A5 


55 


5401 


FD15 


85 


61 


5402 


FD17 


A5 


56 


5403 


FD19 


85 


62 


5404 


FDIB 


A9 


01 


5405 


FDID 


85 


79 


5406 


FDIF 


85 


7A 


5407 


FD21 


38 




5408 


FD22 


A5 


60 


5409 


FD24 


E5 


5A 


5410 


FD26 


85 


76 


5411 


FD28 


BO 


OD 


5412 


FD2A 


A9 


FF 


5413 


FD2C 


85 


79 


5414 


FD2E 


A5 


76 


5415 


FD30 


49 


FF 


5416 


FD32 


18 




5417 


FD33 


69 


01 


5418 


FD35 


85 


76 


5419 


FD37 


38 




5420 


FD38 


A5 


61 


5421 


FD3A 


E5 


5B 


5422 


FD3C 


85 


77 


5423 


FD3E 


A5 


62 


5424 


FD40 


E5 


5C 


5425 


FD42 


85 


78 


5426 


FD44 


BO 


16 


5427 


FD46 


A9 


FF 


5428 


FD48 


85 


7A 


5429 


FD4A 


A5 


77 


5430 


FD4C 


49 


FF 


5431 


FD4E 


85 


77 


5432 


FD50 


A5 


78 


5433 


FD52 


49 


FF 


5434 


FD54 


85 


78 


5435 


FD56 


E6 


77 


5436 


FD58 


DO 


02 
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DRAW — DRAW A LINE FROM OLDROW, OLDCOL TO NEWROW, NEWCOL 
(THE AL MILLER METHOD FROM BASKETBALL) 



DRAW: 



DRAWB: 
DRAW A: 



DRAWl: 



LDX 
LDA 
CMP 
BEQ 
CMP 
BEQ 
LDY 
RTS 
INX 
STX 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
STA 
SEC 
LDA 
SBC 
STA 
BCS 
LDA 
STA 
LDA 
EOR 
CLC 
ADC 
STA 
SEC 
LDA 
SBC 
STA 
LDA 
SBC 
STA 
BCS 
LDA 
STA 
LDA 
EOR 
STA 
LDA 
EOR 
STA 
INC 
BNE 



#0 

ICCOMZ 

#*11 

DRAWA 

#$12 

DRAWB 

#NVALID 



FILFLG 

ROWCRS 

NEWROW 

COLCRS 

NEWCOL 

COLCRS+1 

NEWCOL+1 

#1 

ROW INC 

COL INC 

NEWROW 

OLDROW 

DELTAR 

DRAWl 

#*FF 

ROWING 

DELTAR 

#*FF 

#1 
DELTAR 

NEWCOL 

OLDCOL 

DELTAC 

NEWCOL+1 

OLDCOL+1 

DELTAC+1 

DRAW2 

#*FF 

COL INC 

DELTAC 

#*FF 

DELTAC 

DELTAC+1 

#*FF 

DELTAC+1 

DELTAC 

DRAW2 



TEST COMMAND: *11=DRAW *12=FILL 



TEST FILL 

YES 

NO, SO RETURN INVALID COMMAND 



; PUT CURSOR INTO NEWROW, NEWCOL 



SET UP INITIAL DIRECTIONS 



DETERMINE DELTA ROW 



DO DIRECTION AND ABSOLUTE VALUE 
BORROW WAS ATTEMPTED 
SET DIRECT I ON=DOWN 



DELTAR 



! DELTAR ! 



NOW DELTA COLUMN 



TWO-BYTE QUANTITY 



DIRECTION AND ABSOLUTE VALUE 
BORROW WAS ATTEMPTED 
SET DIRECTION = LEFT 

DELTAC = 1 DELTAC! 



ADD ONE FOR TWOS COMPLEMENT 



ERR LINE 


ADDR 


Bl 


B2 B3 


B4 


5437 


FD5A 


E6 


78 




5438 


FD5C 


A2 


02 




5439 


FD5E 


AO 


00 




5440 


FD60 


84 


73 




5441 


FD62 


98 






5442 


FD63 


95 


70 




5443 


FD65 


B5 


5A 




5444 


FD67 


95 


54 




5445 


FD69 


CA 






5446 


FD6A 


10 


F6 




5447 


FD6C 


A5 


77 




5448 










5449 










5450 


FD6E 


E8 






5451 


FD6F 


A8 






5452 


FD70 


A5 


78 




5453 


FD72 


85 


7F 




5454 


FD74 


85 


75 




5455 


FD76 


DO 


OB 




5456 


FD78 


A5 


77 




5457 


FD7A 


C5 


76 




5458 


FD7C 


BO 


05 




5459 


FD7E 


A5 


76 




5460 


FD80 


A2 


02 




5461 


FD82 


A8 






5462 


FD83 


98 






5463 


FD84 


85 


7E 




5464 


FD86 


85 


74 




5465 


FD88 


48 






5466 


FD89 


A5 


75 




5467 


FD8B 


4A 






5468 


FD8C 


68 






5469 


FD8D 


6A 






5470 


FD8E 


95 


70 




5471 


FD90 


A5 


7E 




5472 


FD92 


05 


7F 




5473 


FD94 


DO 


03 




5474 


FD96 


4C 


42 FE 




5475 


FD99 


18 






5476 


FD9A 


A5 


70 




5477 


FD9C 


65 


76 




5478 


FD9E 


85 


70 




5479 


FDAO 


90 


02 




5480 


FDA2 


E6 


71 




5481 


FDA4 


A5 


71 




5482 


FDA6 


C5 


75 




5483 


FDA8 


90 


14 




5484 


FDAA 


DO 


06 




5485 


FDAC 


A5 


70 




5486 


FDAE 


C5 


74 




5487 


FDBO 


90 


OC 




5488 


FDB2 


18 






5489 


FDB3 


A5 


54 




5490 


FDB5 


65 


79 
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draw; 



DRAW3A: 



DRAW3: 



DRAW4A: 



DRAWll: 



DRAWS: 



DRAW5A: 



INC 
LDX 
LDY 
STY 
TYA 
STA 
LDA 
STA 
DEX 
BPL 
LDA 
STA 
STA 
INX 
TAY 
LDA 
STA 
STA 
BNE 
LDA 
CMP 
BCS 
LDA 
LDX 
TAY 
TYA 
STA 
STA 
PHA 
LDA 
LSR 
PLA 
ROR 
STA 
LDA 
ORA 
BNE 
JMP 
CLC 
LDA 
ADC 
STA 
BCC 
INC 
LDA 
CMP 
BCC 
BNE 
LDA 
CMP 
BCC 
CLC 
LDA 
ADC 



DELTAC+1 

#2 

#0 

COLAC+1 

ROWAC, X 
QLDROW, X 
ROWCRS, X 

DRAW3A 
DELTAC 
COUNTR 
ENDPT 



DELTAC+1 

COUNTR+1 

ENDPT+1 

DRAW3 

DELTAC 

DELTAR 

DRAW3 

DELTAR 

#2 



COUNTR 
ENDPT 

ENDPT+1 
A 

A 

ROWAC, X 
COUNTR 
COUNTR+1 
DRAWll 
DRAW 10 

ROWAC 

DELTAR 

ROWAC 

DRAW5 

ROWAC+1 

ROWAC+1 

ENDPT+1 

DRAW6 

DRAW5A 

ROWAC 

ENDPT 

DRAW6 

ROWCRS 
ROW INC 



; ZERO RAM FOR DRAW LOOP 



;FIND LARGER ONE (ROW OR COL) 
(PREPARE COUNTR AND ENDPT) 

; MAKE X 



; AUTOMATICALLY LARGER IF MSD>0 

; LOW COL >LOW ROW? 
; YES 



;PUT IN INITIAL CONDITIONS 

SAVE AC 

PUT LSB OF HIGH BYTE 

INTO CARRY 

RESTORE AC 

ROR THE 9 BIT ACUMULATOR 

/TEST ZERO 

; IF COUNTER IS ZERO, LEAVE DRAW 

; ADD ROW TO ROWAC (PLOT LOOP) 



COMPARE ROW TO ENDPOINT 

IF HIGH BYTE OF ROW IS . LT. HIGH 

BYTE OF ENDPT, BLT TO COLUMN 



LOW BYTE 
ALSO BLT 
OE SO MOVE POINT 



LINE 


ADDR 


Bl 


B2 


B3 B4 


5491 


FDB7 


85 


54 




5492 


FDB9 


A2 


00 




5493 


FDBB 


20 


7A 


FA 


5494 


FDBE 


18 






5495 


FDBF 


A5 


72 




5496 


FDCl 


65 


77 




5497 


FDC3 


85 


72 




5498 


FDC5 


A5 


73 




5499 


FDC7 


65 


78 




5500 


FDC9 


85 


73 




5501 


FDCB 


C5 


75 




5502 


FDCD 


90 


27 




5503 


FDCF 


DO 


06 




5504 


FDDl 


A5 


72 




5505 


FDD3 


C5 


74 




5506 


FDD5 


90 


IF 




5507 


FDD7 


24 


7A 




5508 


FDD9 


10 


10 




5509 


FDDB 


C6 


55 




5510 


FDDD 


A5 


55 




5511 


FDDF 


C9 


FF 




5512 


FDEl 


DO 


OE 




5513 


FDE3 


A5 


56 




5514 


FDE5 


FO 


OA 




5515 


FDE7 


C6 


56 




5516 


FDE9 


10 


06 




5517 


FDEB 


E6 


55 




5518 


FDED 


DO 


02 




5519 


FDEF 


E6 


56 




5520 


FDFl 


A2 


02 




5521 


FDF3 


20 


7A 


FA 


5522 


FDF6 


20 


96 


FA 


5523 


FDF9 


20 


EO 


F5 


5524 


FDFC 


AD 


B7 


02 


5525 


FDFF 


FO 


2F 




5526 


FEOl 


20 


9D 


FC 


5527 


FE04 


AD 


FB 


02 


5528 


FE07 


8D 


BC 


02 


5529 


FEOA 


A5 


54 




5530 


FEOC 


48 






5531 


FEOD 


20 


DC 


F9 


5532 


FEIO 


68 






5533 


FEll 


85 


54 




5534 


FE13 


20 


96 


FA 


5535 


FE16 


20 


A2 


F5 


5536 


FE19 


DO 


OC 




5537 


FEIB 


AD 


FD 


02 


5538 


FEIE 


8D 


FB 


02 


5539 


FE21 


20 


EO 


F5 


5540 


FE24 


4C 


OA 


FE 


5541 


FE27 


AD 


BC 


02 


5542 


FE2A 


8D 


FB 


02 


5543 


FE2D 


20 


A8 


FC 


5544 


FE30 


38 
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STA 


ROWCRS 




LDX 


#0 




JSR 


SUBEND 


DRAW6: 


CLC 






LDA 


COL AC 




ADC 


DELTAC 




STA 


COL AC 




LDA 


COLAC+1 




ADC 


DELTAC +1 




STA 


COLAC+1 




CMP 


ENDPT+l 




BCC 


DRAWS 




BNE 


DRAW6A 




LDA 


COLAC 




CMP 


ENDPT 




BCC 


DRAWS 


DRAW6A: 


BIT 


COL INC 




BPL 


DRAW6B 




DEC 


COLCRS 




LDA 


COLCRS 




CMP 


i^^FF 




BNE 


DRAW7 




LDA 


COLCRS+1 




BEQ 


DRAW7 




DEC 


COLCRS+1 




BPL 


DRAW7 


DRAW6B: 


INC 


COLCRS 




BNE 


DRAW7 




INC 


COLCRS+1 


DRAW7: 


LDX 


#2 




JSR 


SUBEND 


DRAW8: 


JSR 


RANGE 




JSR 


OUTPLT 




LDA 


FILFLG 




BEQ 


DRAW9 




JSR 


PHACRS 




LDA 


ATACHR 




STA 


H0LD4 


DRAW8A: 


LDA 
PHA 


ROWCRS 




JSR 


INCRSA 




PLA 






STA 


ROWCRS 


DRAW8C: 


JSR 


RANGE 




JSR 


GETPLT 




BNE 


DRAW8B 




LDA 


FILDAT 




STA 


ATACHR 




JSR 


OUTPLT 




JMP 


DRAW8A 


DRAW8B: 


LDA 


H0LD4 




STA 


ATACHR 




JSR 


PLACRS 


DRAW9: 


SEC 





;AND SUBTRACT ENDPT FROM ROWAC 

; DO SAME FOR COLUMN (DOUBLE BYTE ADD) 
; ADD 



; COMPARE HIGH BYTE 

i COMPARE LOW BYTE 

;+ OR - ? 

;D0 DOUBLE BYTE DECREMENT 

; DON'T DEC IF ZERO 

; (UNCONDITIONAL) 

; DO DOUBLE BYTE INCREMENT 

; AND SUBTRACT ENDPT FROM COLAC 



; PLOT POINT 

) TEST RIGHT FILL 



; SAVE ROW IN CASE OF CR 

; POSITION CURSOR ONE PAST DOT 
; RESTORE ROWCRS 



GET DATA 

STOP IF NON-ZERO DATA IS ENCOUNTERED 

FILL DATA 

; DRAW IT 
;LOOP 



; DO DOUBLE BYTE SUBTRACT 



ERR LINE ADDR Bl B2 B3 B4 
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5545 FE31 A5 7E 

5546 FE33 E9 01 

5547 FE35 85 7E 

5548 FE37 A5 7F 
5547 FE39 E9 00 

5550 FE3B 85 7F 

5551 FE3D 30 03 

5552 FE3F 4C 90 FD 

5553 FE42 4C 34 F6 



LDA COUNTR 

SBC #1 

ST A COUNTR 

LDA COUNTR+1 

SBC #0 

STA COUNTR+1 

BMI DRAW 10 

JMP DRAW4A 

DRAW 10: JMP RETURl 



FE45 18 10 OA OA 
FE49 10 IC 34 64 
FE4D C4 C4 C4 C4 



FE51 
FE55 
FE59 
FE5D 
FE61 
FE65 



17 17 OB 17 
2F 2F 5F 5F 
61 61 61 61 
13 13 09 13 
27 27 4F 4F 
41 41 41 41 



ERR LINE ADDR Bi B2 B3 B4 



5554 
5555 
5556 
5557 
5558 
5559 
5560 
5561 
5562 
5563 
5564 
5565 
5566 
5567 
5568 
5569 
5570 
5571 
5572 
5573 
5574 
5575 
5576 
5577 
5578 
5579 
5580 
5581 
5582 
5583 
5584 
5585 
5586 
5587 
5588 
5589 
5590 
5591 
5592 
5593 
5594 
5595 
5596 
5597 
5598 
5599 
5600 
5601 
5602 
5603 
5604 
5605 
5606 
5607 



FE69 02 06 07 08 
FE6D 09 OA OB OD 
FE71 OF OF OF OF 



FE75 00 00 00 00 
FE79 00 00 00 01 
FE7D 01 01 01 01 
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. PAGE 

TABLES 

MEMORY ALLOCATION 
ALOCAT: . BYTE 24, 16, 10, 10, 16, 28, 52, 100, 196, 196, 196, 196 

NUMBER OF DISPLAY LIST ENTRIES 
NUMDLE: .BYTE 23,23,11,23,47,47,95,95,97,97,97,97 

MXDMDE: .BYTE 19,19,9,19,39,39,79,79,65,65,65,65 ; <EXT OF NUMDLE) 
ANTIC CODE FROM INTERNAL MODE CONVERSION TABLE 



INTERNAL 

1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 

ANCONV: . BYTE 



ANTIC CODE 
2 
6 
7 
8 
9 
A 
B 
D 
F 



DESCRIPTION 
40X2X8 CHARACTERS 
20X5X8 
20X5X16 

40X4X8 GRAPHICS 
80X2X4 
80X4X4 
160X2X2 
160X4X2 
320X2X1 



SAME AS 8 BUT GTIA 'LUM' MODE 

SAME AS 8 BUT GTIA 'COL/LUM REGISTER' MODE 

SAME AS 8 BUT GTIA 'COLOR' MODE 

2, 6, 7, 8, 9, *A, *B, *D, *F, *F, *F, *F ; ZEROS FOR RANGE TEST IN 



PAGE TABLE TELLS WHICH DISPLAY LISTS ARE IN DANGER OF 
CROSSING A 256 BYTE PAGE BOUNDARY 

PAGETB: .BYTE 0,0,0,0,0,0,0,1,1,1,1,1 



THIS IS THE NUMBER OF LEFT SHIFTS NEEDED TO MULTIPLY 
COLCRS BY 10,20, OR 40. (R0WCRS*10) /.(2*»DHLINE) 



ERR LINE 


ADDR 


Bl 


B2 


B3 


B4 


5608 












5609 


FE81 


02 


01 


01 


00 


5610 


FE85 


00 


01 


01 


02 


5611 


FEa9 


02 


02 


02 


02 


5612 












5613 












5614 












5615 












5616 


FE8D 


28 


14 


14 


28 


5617 


FE91 


50 


50 


AO 


AO 


5618 


FE95 


40 


50 


50 


50 


5619 












5620 












5621 












5622 












5623 












5624 


FE99 


18 


18 


OC 


18 


5625 


FE9D 


30 


30 


60 


60 


5626 


FEAl 


CO 


CO 


CO 


CO 


5627 












5628 












5629 












5630 












5631 












5632 












5633 


FEA5 


00 


00 


00 


02 


5634 


FEA9 


03 


02 


03 


02 


5635 


FEAD 


03 


01 


01 


01 


5636 












5637 












5638 












5639 












5640 


FEBl 


00 


FF 


FO 


OF 


5641 


FEB 5 


CO 


30 


OC 


03 


5642 












5643 












5644 












5645 


FEB9 


80 


40 


20 


10 


5646 


FEED 


08 


04 


02 


01 


5647 












5648 












5649 












5650 












5651 


FECI 


28 


CA 


94 


46 


5652 


FEC5 


00 








5653 












5654 












5655 












5656 












5657 












5658 












5659 












5660 


FEC6 


IB 








5661 


FEC7 


79 


F7 
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COLUMN: NUMBER OF COLUMNS 
COLUMN: .BYTE 40,20,20,40,80,80,160,160,64,80,80,80 ; MODE 8 IS SPECIAL 



NOROWS: NUMBER OF ROWS 
NOROWS: .BYTE 24,24,12,24,48,48,96,96,192,192,192,192 



DIV2TB: HOW MANY RIGHT SHIFTS FOR HCRSR FOR PARTIAL BYTE MODES 
DIV2TB: .BYTE 0,0,0.2,3.2,3,2,3,1,1,1 

DMASKT: DISPLAY MASK TABLE 



DMASKT: 



. BYTE 
. BYTE 



*00i *FF, *F0, *0F 
*C0, *30, *0C,*03 



MASKTB: BIT MASK. (ALSO PART OF DMASKTB ! DO NOT SEPARATE) 
MASKTB: ^ BYTE *80. *40, *20, *10, *08, *04, *02. *01 



COLRTB: . BYTE *28. *CA, *94, *46. *00 



CNTRLS: CONTROL CODES AND THEIR DISPLACEMENTS INTO THE 
CONTROL CHARACTER PROCESSORS 



CNTRLS: . BYTE 
. WORD 



$1B 
ESCAPE 



ERR LINE 


ADDR 


Bl 


B2 


B3 


B4 


5662 


FEC9 


IC 








5663 


FECA 


7F 


F7 






5664 


FECC 


ID 








5665 


FECD 


8C 


F7 






5666 


FECF 


IE 








5667 


FEDO 


99 


F7 






5668 


FED2 


IF 








5669 


FED3 


AA 


F7 






5670 


FED5 


7D 








5671 


FED6 


B9 


F7 






5672 


FED8 


7E 








5673 


FED9 


E6 


F7 






5674 


FEDB 


7F 








5675 


FEDC 


10 


F8 






5676 


FEDE 


9B 








5677 


FEDF 


30 


FA 






5678 


FEEl 


9C 








5679 


FEE2 


D4 


F8 






5680 


FEE4 


9D 








5681 


FEES 


A4 


F8 






5682 


FEE7 


9E 








5683 


FEES 


32 


F8 






5684 


FEEA 


9F 








5685 


FEEB 


2D 


F8 






5686 


FEED 


FD 








5687 


FEEE 


OA 


F9 






5688 


FEFO 


FE 








5689 


FEFl 


6D 


F8 






5690 


FEF3 


FF 








5691 


FEF4 


37 


F8 






5692 












5693 












5694 












5695 












5696 












5697 












5698 












5699 


FEF6 


40 


00 


20 


60 


5700 












5701 












5702 












5703 












5704 


FEFA 


20 


40 


00 


60 


5705 












5706 












5707 












5708 












5709 


FEFE 


6C 


6A 


3B 


80 


5710 


FF02 


80 


6B 


2B 


2A 


5711 


FF06 


6F 


80 


70 


75 


5712 


FFOA 


9B 


69 


2D 


3D 


5713 


FFOE 










5714 


FFOE 


76 


80 


63 


80 


5715 


FF12 


80 


62 


78 


7A 
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BYTE 


*1C 


WORD 


CRSRUP 


BYTE 


«1D 


WORD 


CRSRDN 


BYTE 


HIE 


WORD 


CRSRLF 


BYTE 


*1F 


WORD 


CRSRRT 


BYTE 


*7D 


WORD 


CLRSCR 


BYTE 


$7E 


WORD 


BS 


BYTE 


*7F 


WORD 


TAB 


BYTE 


*9B 


WORD 


DOCRWS 


BYTE 


*9C 


WORD 


DELL IN 


BYTE 


*9D 


WORD 


INSLIN 


BYTE 


*9E 


WORD 


CLRTAB 


BYTE 


*9F 


WORD 


SETTAB 


BYTE 


*FD 


WORD 


BELL 


BYTE 


*FE 


WORD 


DELCHR 


BYTE 


$FF 


WORD 


INSCHR 



ATA I NT: ATASCI TO INTERNAL TABLE 
ATA INT: . BYTE *40, *00/ *20, *60 

INTATA: INTERNAL TO ATASCI TABLE 
INTATA: . BYTE *20, *40, *00, *60 

ATASCI: ATASCI I CONVERSION TABLE 
ATASCI: .BYTE *6C, *6A, *3B, *80, *80/ *6B, *2B/ *2A ; LOWER CASE 
. BYTE *6F, *80, *70, *75, *9Bi *69, *2D, *3D 

. BYTE *76, *80, *63. *80, $80, $62, $78, $7A 



ERR LINE 


ADDR 


Bl 


B2 


B3 


B4 


5716 


FF16 


34 


80 


33 


36 


5717 


FFIA 


IB 


35 


32 


31 


5718 


FFIE 










5719 


FFIE 


2C 


20 


2E 


6E 


5720 


FF22 


80 


6D 


2F 


81 


5721 


FF26 


72 


80 


65 


79 


5722 


FF2A 


7F 


74 


77 


71 


5723 


FF2E 










5724 


FF2E 


39 


80 


30 


37 


5725 


FF32 


7E 


38 


3C 


3E 


5726 


FF36 


66 


68 


64 


80 


5727 


FF3A 


82 


67 


73 


61 


5728 


FF3E 










5729 


FF3E 










5730 


FF3E 


4C 


4A 


3A 


80 


5731 


FF42 


80 


4B 


5C 


5E 


5732 


FF46 


4F 


80 


50 


55 


5733 


FF4A 


9B 


49 


5F 


7C 


5734 


FF4E 










5735 


FF4E 


56 


80 


43 


80 


5736 


FF52 


80 


42 


58 


5A 


5737 


FF56 


24 


80 


23 


26 


5738 


FF5A 


IB 


25 


22 


21 


5739 


FF5E 










5740 


FF5E 


5B 


20 


5D 


4E 


5741 


FF62 


80 


4D 


3F 


81 


5742 


FF66 


52 


80 


45 


59 


5743 


FF6A 


9F 


54 


57 


51 


5744 


FF6E 










5745 


FF6E 


28 


80 


29 


27 


5746 


FF72 


9C 


40 


7D 


9D 


5747 


FF76 


46 


48 


44 


80 


5748 


FF7A 


83 


47 


53 


41 


5749 


FF7E 










5750 


FF7E 










5751 


FF7E 


OC 


OA 


7B 


80 


5752 


FF82 


80 


OB 


IE 


IF 


5753 


FF86 


OF 


80 


10 


15 


5754 


FF8A 


9B 


09 


IC 


ID 


5755 


FF8E 










5756 


FF8E 


16 


80 


03 


80 


5757 


FF92 


80 


02 


18 


lA 


5758 


FF96 


80 


80 


85 


80 


5759 


FF9A 


IB 


80 


FD 


80 


5760 


FF9E 










5761 


FF9E 


00 


20 


60 


OE 


5762 


FFA2 


80 


OD 


80 


81 


5763 


FFA6 


12 


80 


05 


19 


5764 


FFAA 


9E 


14 


17 


11 


.5765 


FFAE 










5766 


FFAE 


80 


80 


80 


80 


5767 


FFB2 


FE 


80 


7D 


FF 


5768 


FFB6 


06 


08 


04 


80 


5769 


FFBA 


84 


07 


13 


01 



DISPLAY HANDLER — 10-30-78 ~ DISPLC 

. BYTE *34, *80. *33, *36. *1B. *35, *32. *31 

. BYTE *2C, *20, *2E. *6E, *80, *6D, *2F, *81 

. BYTE *72/ *80, »65, *79, *7F, *74, *77. *71 

. BYTE *39, *80, *30, *37, *7E, *38, *3C, *3E 

. BYTE *66, *68, *64, *80, *82, *67, *73, *61 

.BYTE *4C/ *4A/ *3A, *80, *80, *4B. *5C, *5E ; UPPER CASE 

. BYTE *4F/ *80, *50, *55, *9B, *49, *5F, *7C 

. BYTE *56. *80, *43, *80. *80, *42, *58. *5A 

. BYTE *24, *80/ *23, *26, *1B, *25, *22, *21 

. BYTE *5B, *20, *5D. *4E. *80, *4D, *3F. *81 

. BYTE *52. *80, *45, *59, *9F, *54, *57, *51 

. BYTE *28, *80, *29, $27, *9C, *40, *7D, *9D 

. BYTE *46, *48, *44, *80, *83, *47, *53, *41 

.BYTE *0C. *0A, *7B,*80, *80, *0B, *1E, *1F ; CONTROL 

.BYTE *0F, *80i*10, *15, *9B, *09, *1C, *1D 

. BYTE $16, *80. *03, *80, *80, *02, $18, *1A 

. BYTE *80, *80, *85. *80. *1B, *80, *FD, *80 

. BYTE *00, *20, *60, *0E/ *80, *0D, *80, *81 

. BYTE *12, *80, *05, *19/ *9E, *14, *17, *1 1 

. BYTE *80, *80, *80/ *80, *FE, *80, *7D, *FF 

. BYTE $06, *08, $04, *80, *84, *07, *13, *01 
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ERR LINE 


ADDR 


Bl 


B2 


B3 B4 


5770 










5771 










5772 










5773 










5774 










5775 


FFBE 


AD 


09 


D2 


•^llb 


FFCl 


CD 


F2 


02 


5777 


FFC4 


DO 


05 




5778 


FFC6 


AD 


Fl 


02 


5779 


FFC9 


DO 


20 




5780 


FFCB 


AD 


09 


D2 


5781 


FFCE 


C9 


9F 




5782 


FFDO 


DO 


OA 




5783 


FFD2 


AD 


FF 


02 


5784 


FFD5 


49 


FF 




5785 


FFD7 


8D 


FF 


02 


5786 


FFDA 


BO 


OF 




5787 


FFDC 


8D 


FC 


02 


5788 


FFDF 


8D 


F2 


02 


5789 


FFE2 


A9 


03 




5790 


FFE4 


8D 


Fl 


02 


5791 


FFE7 


A9 


00 




5792 


FFE9 


85 


4D 




5793 


FFEB 


A9 


30 




5794 


FFED 


8D 


2B 


02 


5795 


FFFO 


68 






5796 


FFFl 


40 






5797 










5798 










5799 


FFF2 


FF 


FF 


FF FF 


5800 


FFF6 


FF 


FF 




5801 










5802 


FFF8 








5803 










5804 


0014 


00 






5805 


0015 
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PIRQ5: 


LDA 


KBCODE 




CMP 


CHI 




BNE 


PIRQ3 




LDA 


KEYDEL 




BNE 


PIRQ4 


PIRQ3: 


LDA 


KBCODE 




CMP 


#CNTL1 




BNE 


PIRQl 




LDA 


SSFLAG 




EOR 


#*FF 




STA 


SSFLAG 




BCS 


PIRQ4 


PIRQl: 


STA 


CH 




STA 


CHI 




LDA 


#3 




STA 


KEYDEL 




LDA 


#0 




STA 


ATRACT 


PIRQ4: 


LDA 


#*30 




STA 


SRTIMR 


PIRQ2: 


PLA 
RTI 





. BYTE 



CRNTPC =* 

*=*14 

KBDSPR: .BYTE 
. END 



; TEST AGAINST LAST KEY PRESSED 

i IF NOT, GO PROCESS KEY 

; IF KEY DELAY BYTE > O 

/ IGNORE KEY AS BOUNCE 

; RESTORE AC 

; TEST CONTROL 1 (SSFLAG) 



; (UNCONDITIONAL) MAKE -l INVISIBLE 



i INITIALIZE KEY DELAY FOR DEBOUNCE 
; CLEAR COLOR SHIFT BYTE 



%¥¥, *FF, *FF, *FF, *FF, $FF 



*FFF8-CRNTPC ; -^GDISPLC IS TOO LONG 



ASSEMBLY ERRORS = 



DISPLAY HANDLER 



10-30-78 



DISPLC 



PAGE 129 



CROSS REFERENCE 



LABEL 



VALUE 



REFERENCE 



ACK 


0041 


-1632 


1902 














ACKREC 


E9C6 


1785 


-1794 














ADDCOR 


030E 


-498 


2515 


2519 


2523 










ADJl 


EDOC 


2533 


-2537 














ADJUST 


ED04 


2470 


2473 


-2532 












ADRESS 


0064 


-269 


4120 


4145 


4171 


4173 


4182 


4183 


4184 






4186 


4252 


4254 


4258 


4260 


4263 


4265 


4296 






4355 


4357 


4426 


4443 


4445 


4570 


4573 


4574 






4653 


4655 


4681 


4686 


4748 


4755 


4758 


4760 






4762 


4766 


4834 


4835 


4838 


4839 


5092 


5094 






5101 


5104 


5106 


5149 


5161 


5163 


5165 


5168 






5171 


5175 


5176 


5178 


5179 


5287 


5378 


5380 


ADRTAB 


E6FE 


-1292 


1327 














AFP 


D800 


-574 
















ALLPOT 


D208 


-659 
















ALLSEC 


F30E 


3886 


-3891 














ALOCAT 


FE45 


4146 


-5562 














ANCONV 


FE69 


4139 


-5593 














ANTIC 


D400 


-735 


736 


737 


738 


739 


740 


741 


742 






743 


744 


745 


746 


747 


748 


749 


750 


APPEND 


0001 


-111 
















APPMHI 


OOOE 


-179 


4761 


4765 












ASCCOl 


F705 


4478 


-4480 














ASCZER 


0030 


-764 


1193 














ATAGHR 


02FB 


-469 


4308 


4311 


4316 


4333 


4372 


4394 


4417 






4421 


4428 


4481 


4515 


4526 


4528 


4606 


5082 






5300 


5527 


5538 


5542 










ATA I NT 


FEF6 


4343 


-5699 














ATAN 


BE43 


-602 
















ATASCI 


FEFE 


4480 


-5709 














ATEOF 


FOOB 


3250 


-3256 














ATRAC T 


004D 


-248 


1340 


1395 


1401 


1403 


5792 






AUDCl 


D201 


-667 


2343 


2353 


2378 










AUDC2 


D203 


-669 


2354 














AUDC3 


D205 


-671 


2349 














AUDC4 


D207 


-673 
















AUDCTL 


D208 


-674 


2336 














AUDFl 


D200 


-666 


2297 














AUDF2 


D202 


-668 


2295 














AUDF3 


D204 


-670 


1749 


2203 


2607 


3200 








AUDF4 


D206 


-672 


1751 


2205 


2609 


3202 








B192HI 


0000 


-1641 


1750 














B192L0 


0028 


-1640 


1748 














B600HI 


0005 


-1643 


2204 














B600L0 


OOCC 


-1642 


2202 














BAD 


EA63 


1919 


-1925 














BADCOM 


E9BF 


1782 


-1788 


1809 












BADDSK 


F306 


-3887 


3923 


3929 












BAD IOC 


0086 


-142 


826 















BADMOD 


0091 


BADST 


EE9E 


BEEP 


F058 


BEEPl 


F05A 


BEGIN 


EDIO 


BELL 


F90A 


BELLI 


F90C 


BFENHI 


0035 


BFENLQ 


0034 


BITCLR 


FB12 


B I ICON 


FAEB 


BITGEl 


FB31 


BITOET 


FB25 


BITMSK 


006E 


BITPUT 


FB04 


BITROL 


FAFA 


BITSET 


FB06 


BLACKB 


F22A 


BLFILL 


EECl 


BLIM 


028A 


BLKB2 


F230 


BLKBDV 


E471 


BLOAD 


F36C 


BOOT 


F2CF 


BOOTAD 


0242 


BOOT? 


0009 


BOTSCR 


02BF 


BPTR 


003D 


BRKABT 


0080 


BRKKEY 


0011 


BRKKY 


0236 


BRKKY2 


E754 


BROKE 


EDAO 


BS 


F7E6 


BSl 


F80D 


BS2 


FS05 


BS3 


F7F5 


BSA 


F7EC 


BUFADR 


0015 


BUFCNT 


006B 


BUFFH 


0004 


BUFFL 


0000 


BUFFUL 


EECB 


BUFRFL 


0038 


BUFRHI 


0033 


BUFRLO 


0032 


BUFSTR 


006C 



-154 
2914 
3164 

-3315 
2255 
4402 

-4727 
-224 
-223 
4624 

-5019 
5060 
4618 
-276 
4711 

-5032 
4622 

-3740 
2992 
-398 
3740 
-77 
3928 
3710 
-360 
-176 
-429 
-234 
3274 
-136 
-184 
3220 
-345 

-1336 
1959 

-4591 
4593 
4601 
4596 

■4594 
-187 
-274 
5249 

-3421 

-3422 
2989 
-227 
-222 
2624 
-221 
2140 
-275 
5214 



4141 
2917 
3197 
3349 

-2558 

-4726 
4729 
1774 
1771 
5038 
5040 

-5062 
4890 
5023 

-5038 
5159 

-5040 
3741 

-2995 
3183 

-3742 
3483 

-3933 

-3862 
3896 
3864 
4193 
3182 
3293 
2637 
1337 
3831 
1292 
3832 
2066 
5673 

-4608 
4603 

-4598 

2829 
4386 

3422 
3881 
-3000 
2054 
1773 
2626 
1769 
2144 
4389 
5216 



2963 
-3314 

2570 
5687 

1886 

1883 

-5046 

5046 

-5056 
5042 
5129 



3015 
3235 

3601 



3898 
3931 
4201 
3225 

3188 
1957 
4467 
3833 
3834 
2560 



-4605 



2838 
4410 

3883 



2111 
1885 

1881 
2177 
4391 
5263 



-2965 



1985 
1983 

5056 



2147 
2145 



2184 
2179 



5047 5059 
5138 



3254 
3603 



3934 3937 

3991 4007 

4542 4548 4664 4953 5335 

3234 3238 3246 3263 3265 



2643 3189 



4466 4983 

2064 2558 2580 

4509 4984 4985 
3835 

2581 -2632 



2842 2863 2865 

4412 5219 5229 5232 5240 



2160 

1980 1984 2142 2146 2182 



1951 1978 1982 

2615 2617 2621 

4406 4408 4584 
5265 



2009 2133 

2623 

4588 4927 



CAINI 


F239 


CART 


BFFC 


CARTAD 


BFFE 


CARTCS 


BFFA 


CARTFG 


BFFD 


CAS31 


EC5E 


CASBUF 


03FD 


CASENT 


EB80 


CASET 


0060 


CASETV 


E440 


CASFLG 


030F 


CASINI 


0002 


CASORG 


EF41 


CASRED 


EBB3 


CASSBT. 


004B 


C ASSET 


0043 


CASSPR 


0014 


CAUXl 


023C 


CAUX2 


023D 


CBAUDH 


02EF 


CBAUDL 


02EE 


CBINI 


F23C 


CBUFH 


0003 


CBUFHI 


0002 


CBUFL 


OOFD 


CBUFLO 


003A 


CCOMND 


023B 


CDEVIC 


023A 


CDTMAl 


0226 


CDTMA2 


0228 


CDTMF3 


022A 


CDTMF4 


022C 


CDTMF5 


022E 


CDTMVl 


0218 


CDTMV2 


021A 


CDTMV3 


021C 


CDTMV4 


021E 


CDTMV5 


0220 


CDUBL 


EF26 


CH 


02FC 


CHI 


02F2 


CHACT 


02F3 


CHACTL 


D401 


CHAR 


02FA 


CHBAS 


02F4 


CHBASE 


D409 


CHKDON 


EABA 


CHKERR 


008F 


CHKSNT 


003B 


CHKSUM 


0031 



3669 

-3436 

-3438 

-3435 

-3437 

2352 

-545 

3301 

3902 

1734 

-1611 

-59 

-499 

-169 

-30 

2198 

-245 

-124 

-3398 

-351 

-352 

-457 

-456 

3661 

-3101 

-1669 

-3102 

-1670 

-350 

-349 

-330 

-331 

-332 

-334 

-336 

-323 

1564 

-324 

-325 

-326 

-327 

3072 

-470 

-461 

-463 

-737 

-468 

-464 

-743 

1995 

-151 

-230 

-220 



-3750 
3658 
3750 
3720 
3702 

-2357 
3101 
3389 
3905 

-2197 
1732 
3118 
1739 
4009 
3097 

-2233 
3888 



1763 
1765 
2602 
2601 
-3751 
3102 
1670 
3368 
1768 
1760 
1669 
1528 
1529 
1455 



1451 
1566 



-3075 
1478 
5776 
1442 
1443 
4302 
1440 
1441 

-2002 
2118 
1947 
1946 



3666 3781 3783 3784 3793 

3751 3788 

3726 

3705 3717 3723 3786 

3102 3237 3248 3253 3264 3295 

3391 3392 3421 3422 3892 3900 



2289 2351 

3513 3849 

2050 2234 

4011 4014 
3136 

3922 3925 3975 4001 4005 



2608 3144 
2606 3142 

3366 
1772 



1670 1757 
2653 2655 

3177 3179 3219 3222 



1452 1535 1537 1539 1540 1542 



4087 4462 4469 4474 5787 

5788 

4110 

4344 4346 5069 5079 
4108 

2017 

1988 1994 2026 

1955 1991 2013 2015 2053 2115 



CHKTIM 


EAF9 


CHRORG 


EOOO 


CICL02 


E53F 


CICLOS 


E533 


CIERRl 


E4D1 


CIERR2 


E6B0 


CIERR3 


E50F 


CIERR4 


E511 


CI JUMP 


E693 


CINI 


F3E1 


CIO 


E4G4 


CIOCHR 


002F 


CIOIl 


E4A8 


CIOINT 


E4A6 


CIOINV 


E46E 


CIOORG 


E4A6 


CI OPEN 


E509 


CIOSPR 


0014 


CIOV 


E456 


CIREAD 


E569 


CIRT3 


E62B 


CIRTNl 


E61B 


CIRTN2 


E61D 


CISTl 


E559 


CISTSP 


E54E 


CIWRIT 


E5C9 


CIX 


00F2 


CKEY 


004A 


CKSTC 


EEll 


CLICK 


FCD8 


CLICKl 


FCDA 


CLOSE 


OOOC 


CLOSEC 


F02B 


CLRCHP 


F27A 


CLRCOD 


007D 


CLRLIi 


FBA6 


CLRLIN 


FB9B 


CLRRAM 


F140 


CLRSC2 


F7BF 


CLRSC3 


F7CE 


CLRSCR 


F7B9 


CLRTAB 


F832 


CLRTBS 


F430 


CLS 


007D 


CLWRT 


F038 


CMODE 


EFIE 


CMPTAB 


E6F6 


CNTLl 


009F 


CNTRLS 


FEC6 


COL AC 


0072 


COLBK 


DOIA 



2136 

-2064 

-22 

901 

853 

821 

1173 

-869 

842 

1152 

3994 

771 

-217 

1026 

-787 

775 

-76 

-25 

851 

-1215 

-68 

857 

-1075 

827 

893 

916 

855 

858 

-616 

-244 

2808 

4475 

-5356 

-93 

3119 

-3820 

-4030 

-5149 

4697 

-3591 

-4570 

-4578 

4280 

-4623 

-4125 

-3416 

3287 

-3071 

-1282 

-4031 

4442 

-279 

-708 



2138 
2071 

-903 

-898 

-826 

-1183 

-870 
-1158 
-4014 
-815 

815 
1037 

798 
-786 

774 

783 
-864 

770 

-934 

1080 

870 

909 

-923 

-914 

-1003 

3856 

-2810 

4727 

5359 

-3286 
3825 
4312 
5151 

-5144 
3594 
4572 
4581 
4314 
5683 
4127 
3527 

-3293 
3087 
1313 
5781 
4444 
5440 



2619 



874 880 920 



951 956 966 985 989 1019 
1083 

1212 
3850 



3683 3967 



940 1009 -1065 

930 952 999 1060 -1069 



3997 4006 
■5355 



3598 
4576 

-4567 5671 



5299 -5660 

5495 5497 5498 5500 5504 



COLCR 


FCE4 


COLCRl 


FCEE 


C0LCR2 


FCFO 


COLCRS 


0055 



COLDST 


0244 


COLDSV 


E477 


COL INC 


007A 


COLON 


003A 


COLORO 


02C4 


COLOR 1 


02C5 


C0L0R2 


02C6 


C0L0R3 


02C7 


COLOR 4 


02C8 


COLPFO 


D016 


COLPFl 


D017 


C0LPF2 


D018 


C0LPF3 


D019 


COLPMO 


D012 


COLPMl 


D013 


C0LPM2 


D014 


C0LPM3 


D015 


COLRSH 


004F 


COLRTB 


FECI 


COLUMN 


FE8D 


COM! 


E647 


COM2 


E662 


COMENT 


E63D 


COMFRM 


E978 


COMMND 


E974 


COMPLT 


0043 


COMPUT 


EC A3 


COMREl 


F7A7 


COMRET 


F789 


COMTAB 


E6C9 


CONSOL 


DOIF 


CONTIN 


EC31 


CONVRl 


F97E 


C0NVR2 


F988 


C0NVR3 


F98F 


C0NVR4 


F99C 


C0NVR5 


F9A6 


C0NVR6 


F9A7 


CONVRT 


F947 


COS 


BD73 


COUNT 


ED3B 


COUNTR 


007E 



CR 



009B 



4582 


4901 


-5365 












5367 


-5370 














5369 


-5371 














-259 


4390 


4409 


4552 


4553 


4558 


4560 


4561 


4587 


4594 


4599 


4610 


4679 


4719 


4778 


4780 


4811 


4816 


4845 


4847 


4860 


4862 


4863 


4875 


4903 


4970 


4975 


4978 


5145 


5202 


5217 


5226 


5245 


5371 


5400 


5402 


5509 


5510 


5513 


5515 


5517 


5519 














-361 


3565 


3606 


3714 










-79 


3491 














-284 


5406 


5428 


5507 










-765 
















-436 


4130 














-437 
















-438 
















-439 
















-440 


4169 














-704 
















-705 
















-706 
















-707 
















-700 


1437 














-701 
















-702 
















-703 
















-250 


1407 


1435 












4129 


-5651 














4865 


4977 


-5616 












1095 


-1102 














1099 


-1116 














879 


888 


900 


923 


943 


1012 


-1093 




■1748 


1789 














■1743 


1856 














•1634 


1904 














2468 


2600 














4556 


-4559 


4563 


4564 










4541 


-4545 


4549 












850 


1107 


-1209 












-713 


1432 


3325 


3330 


3853 


5356 






2307 


-2331 














4805 


4809 














4806 


-4810 














4813 


4819 














4814 


-4820 














4824 


-4826 














4827 


4830 














4295 


4345 


4652 


4680 


4720 


-4776 


5146 


5282 


-601 
















2580 


2591 


2594 


2604 










-288 


5453 


5463 


5471 


5472 


5545 


5547 


5548 


5550 
















-129 


2991 


3527 


3539 


3551 


4317 


4395 


4420 







4510 
















CRETRI 


OOOD 


-1672 


1743 


1802 












CRETRN 


EBDF 


2227 


-2259 














CRETRY 


0036 


-225 


1744 


1788 


1803 










CRITIC 


0042 


-239 


1412 


1729 


1863 










CRLOOP 


F5E7 


-4329 


4332 














CRNTPl 


E6D5 


-1213 


1215 














CRNTP2 


E90B 


-1582 


1584 














CRNTP3 


EDE8 


-2725 


2727 














CRNTP4 


EE78 


-2872 


2875 














CRNTP5 


EF41 


-3093 


3097 














CRNTP6 


F0E3 


-3396 


3398 














CRNTP7 


F3E4 


-4020 


4023 














CRNTPC 


FFF8 


-5802 


5804 














CRSINH 


02F0 


-459 


1339 


4122 


4365 










CRSRDN 


F78C 


-4546 


5665 














CRSRLl 


F7A3 


4554 


-4557 














CRSRLF 


F799 


-4552 


4598 


5237 


5244 


5667 








CRSROR 


008D 


-149 


4989 














CRSRRT 


F7AA 


-4560 


4609 


5669 












CRSRUP 


F77F 


-4540 


4604 


5663 












CSBOOT 


F3B2 


3694 


-3989 














CSB0T2 


F3C0 


3990 


-3997 














CSIDE 


EF2E 


3076 


-3079 














CSIO 


FOAC 


-3370 
















CSOPIV 


E47D 


-81 


3132 


4002 












CSTAT 


0288 


-396 
















CTIA 


DOOO 


-681 


682 


683 


684 


685 


686 


687 


688 






689 


690 


691 


692 


693 


694 


695 


696 






697 


698 


699 


700 


701 


702 


703 


704 






705 


706 


707 


708 


709 


710 


711 


712 






713 


714 


715 


716 


717 


718 


719 


720 






721 


722 


723 


724 


725 


726 


727 


728 






729 


730 


731 


732 


733 








CTIMHI 


0000 


-1675 


2446 














CTIMLO 


0002 


-1674 


2445 














CTRLC 


0092 


-3417 
















D 


0044 


-2901 


3075 














DAUXl 


030A 


-494 


1762 


2960 


3084 


3880 


3918 






DAUX2 


030B 


-495 


1764 


2210 


2237 


2259 


3383 


3878 




DBDDEC 


F913 


4188 


-4740 














DBDEC 


F91F 


4178 


-4751 














DBSECT 


0241 


-359 


3916 














DBSUB 


■ F921 


4148 


4165 


4741 


-4752 










DBSUBl 


F934 


4759 


-4761 














DBUFHI 


0305 


-489 


2181 


2815 


2864 


3035 


3367 


3884 




DBUFLO 


0304 


-488 


2176 


2813 


2862 


3034 


3369 


3882 




DBUFSZ 


0014 


-2894 


3077 














DBYTHI 


0309 


-493 


2183 


2820 


2850 


3049 


3363 






DBYTLO 


0308 


-492 


2178 


2818 


2848 


3047 


3365 






DCB 


0300 


-483 
















DCOMND 


0302 


-486 


1759 


2799 


2806 


2824 


2831 


2959 


3041 






3083 


3361 


3376 


3872 


3979 









DCTIMl 


E8DD 


1536 


-1540 










DCTIMR 


E8D0 


1409 


1445 


1454 


-1535 






DCTXF 


ESEA 


1538 


1541 


1543 


-1546 






DDEVIC 


0300 


-484 
3371 


1731 


1754 


2288 


2350 


2797 


DECBFl 


E66D 


1124 


-1126 










DECBFL 


E663 


969 


973 


1040 


1044 


-1121 




DEGFLG 


OOFB 


-621 












DEGON 


0006 


-624 












DELAYO 


EC8C 


-2437 


2441 










DELAY 1 


EC8E 


-2438 


2439 










DELCHl 


F870 


-4652 


4669 










DELCH2 


F896 


4662 


4665 


-4670 








DELCHR 


F86D 


-4651 


5689 










DELETE 


0021 


-101 












DELL 11 


F8DD 


-4703 


4714 










DELL I 2 


F8F8 


-4718 












DELL I A 


F8D7 


-4700 












DELL IB 


F8DB 


-4702 


4724 


5291 








DELL IN 


F8D4 


-4699 


5679 










DELTAC 


0077 


-282 


5422 


5425 


5429 


5431 


5432 






5437 


5447 


5452 


5456 


5496 


5499 


DELTAR 


0076 


-281 


5410 


5414 


5418 


5457 


5459 


DELTIl 


FC82 


-5287 


5290 










DELTI2 


FC89 


-5291 












DELTI3 


FC8C 


5281 


5288 


-5292 








DELTIA 


FC68 


4673 


-5274 










DELTIB 


FC70 


5276 


-5278 










DELTIM 


FC73 


4597 


-5279 










DERR 


E9F6 


1821 


-1842 
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I . INTRODUCTION 



The ATARI (R) 800^^ and ATARI 400^^ Personal Computer Systems 
contain a 6502 microprocessor, 4 1/0 chips, operating system ROM, expandable 
RAM, and several MSI chips for address decoding and data bus buffering. 
This manual is primarily intended to describe the 4 1/0 chips in sufficent 
detail to allow experienced programmers to create assembly language programs, 
such as video games. All four Input/Output chips are controlled by the 
microprocessor by writing directly into their registers which are decoded 
to exist in microprocessor memory space just as RAM does. These I/O chips 
can also be interrogated by the microprocessor by reading similar registers. 

Many registers are write only and cannot be read after they are 
written. In some cases, reading from the same address gives the value 
contained in a separate read only register. Some write only registers are 
strobes. No data bits are needed in this case since the presence of the 
address on the bus is what triggers the requested action. The usual 
convention is to use the STA (Store Accumulator) instruction for such 
registers. For example, STA WSYNC performs the wait for Sync function. 
STX (Store X) or STY (Store Y) would work just as well. In BASIC, a POKE 
could be used (the data could be anything). Reading a register is accomp- 
lished by using any of the load instructions (LDA, LDX etc.). In BASIC 
a PEEK would be used. When the hardware register names are defined in an 
equate list, the programmer can refer to the registers by name rather than 
using the addresses directly. 

It is really not necessary for the programmer to know which 
I/O functions are performed by which of the 4 chips, however it 
does help in learning these functions. 

This manual should be used in conjunction with the Operating 
System (OS) Manual, a 6502 programming manual, and the ATARI 400/800 
Basic Reference Manual . 

CHIP NAME FUNCTION 

ANTIC DMA(Direct Memory Access) control 

NMI(Non-Maskable Interrupt) control 
Vertical and Horizontal fine scrolling 
Light pen position registers 
Vertical line counter 
WSYNC (wait for horizontal sync) 

CTIA Priority control (display of overlapping objects) 

Color-Lumimance control (colors and brightness assigned 
to all objects including DMA objects from ANTIC) 
PLAYER-MISSILE objects (4 players and 4 missiles) 

Graphics registers 

Size control 

Horizontal position control 
Collision detection between all objects 
Switches and triggers (miscellaneous l/O functions) 
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CHIP NAME FUNCTION 

POKEY Keyboard scan and control 

Serial communications port (bidirectional) 

Pot scan (digitizes position of 8 Independent pots) 

Audio generation (4 channels) 

Timers 

IRQ (maskable interrupt) control from peripherals 

Random number generator 



PIA Controller (Joystick) jacks read or write 

Peripheral control and interrupt lines 
IRQ (maskable) interrupt control from peripherals 



Section II describes the hardware in some detail, including the 
various graphics modes. Section III lists the hardware registers one at a 
time, describing what each bit is used for. It is organized by functional 
groups (interrupts, graphics, audio, etc.). Section IV contains a sample 
display program. Section V contains various figures and block diagrams of 
the system. Sections VI and VII list the hardware registers in address 
order and alphabetical order. Section VII includes hex and decimal 
addresses, the OS shadow registers and the page numbers where more infor- 
mation can be found. 
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II. DESCRIPTION OF HARDWARE 



A. ANTIC AND CTIA 



TV Display : The ANTIC and CTIA chips generate the television 
display at the rate of 60 frames per second on the NTSC (US) system. 
The PAL (European) system Is different and Is described In the section 
on NTSC vs PAL. Each frame consists of 262 horizontal TV lines and each 
line is made up of 228 color clocks, as shown in figure VI-3. The 6502 
microprocessor runs at 1.79 MHz. This rate was chosen so that one 
machine cycle is equivalent in length to two color clocks. One clock 
is approximately equal in width to two TV lines. 

In any graphics mode, the display is divided up into small squares 
or rectangles called pixels (picture elements). The highest resolution 
graphics mode has a pixel size of 1/2 color clock by 1 TV line. A 
sample display list is given in section IV. 

The current TV line may be determined by reading the vertical counter 
(VCOUNT). This register gives the line count divided by 2. There are 262 
lines per frame so VCOUNT runs from to 130 (0 to 155 on the PAL system). 
The point occurs near the end of vertical blank (see figure VI. 5). 
Vertical blank (VBLANK) is the time during which the electron beam returns 
back to the top of the screen in preparation for the next frame. The 
Atari 800 does not do interlacing, so each frame is identical unless 
the program which is being executed changes the display. Vertical sync 
(VSYNC) occurs during the fourth through sixth lines of vertical blank 
(VCOUNT = hex 7D through 7F) . This tells the TV set where each frame 
starts. After VSYNC, there are 16 more lines of VBLANK for a total of 22 
lines of VBLANK. The display list jump and wait instruction (to be 
described later) causes the display list graphics to start at the end of 
VBLANK. 



Operating System (OS) : The ATARI 400/800 comes with a lOK Operating 
System (OS) in ROM. The OS affects some of the hardware registers, so 
it will be mentioned from time to time in this manual. Refer to the OS 
manual for more details. The OS descriptions in this manual apply to the 
version that was being distributed when this manual was written. 

The OS supports most of the hardware graphics modes (BASICS, GRAPHICS, 
PLOT, and DRAWTO commands). The OS always displays 24 background lines after 
the end of vertical blank. This convention is used at Atari to compensate 
for television sets which overscan. Most TV's are designed so that the 
edges of the picture are cut off. This is fine for ordinary broadcasts, 
but with a computer it is essential for all Important information to be 
displayed on the screen. It is fairly common for four to eight color 
clocks at the right or left edge of the picture to overscan. A TV set 
that has excessive overscan may have to readjusted to obtain a satisfactory 
display. 
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The OS uses 192 TV lines for its display and devotes the remaining 
24 lines to overscan. It uses the standard display width of 160 color 
clocks. The hardware will allow displays of any length, but it is recom- 
mended that the standards be followed. The exception might be a border 
or other information which is merely decorative and not essential to use 
of the program. 



OS Shadowing ; Since many of the hardware registers are write-only 
and cannot be read the OS has a number of "shadow registers" in RAM. 
Every TV frame during vertical blank the OS takes the values in some of 
its shadow registers, and writes them out to the corresponding hardware 
register. The OS does attract color shifting on all of the color registers 
if ATRACT (on OS register) is negative. This is to prevent damage to the 
TV screen phosphors which can occur if the brightness is turned up too high 
and the same high- luminance display is left on for a long time. The OS also 
reads the joysticks and other controllers during vertical blank and stores 
the results in shadow registers, so that user programs do not have to include 
code to unpack the data. There are a few interrupt-related registers which 
the OS changes or reads during interrupt processing. Programs usually access 
the OS shadow registers instead of accessing the hardware directly. However, 
the OS shadowing can be disabled by changing the vertical blank and interrupt 
vectors (see OS manual) . 



WSYNC: In addition to a Vertical Blank Interrupt, which allows the 
Microprocessor to synchronize to the vertical TV display, this system also 
provides a Wait for Horizontal Sync (WSYNC) command that allows the 
microprocessor to synchronize itself to the TV horizontal line rate. This 
sync takes effect when the processor writes to an I/O location called 
WSYNC, whenever it desires horizontal synchronization. Writing to this 
address sets a latch which pulls to zero a pin on the microprocessor 
called READY. When READY goes to zero the microprocessor stops and waits. 
The latch is automatically reset (returning READY true) at the beginning 
of the next horizontal blank interval, releasing the microprocessor to 
resume program execution. 



Object DMA (Direct Memory Access) ; The primary function of the Antic 
chip is to fetch data from memory (independent of the microprocessor) for 
display on the TV screen. It does this with a technique called "Direct 
Memory Access" or DMA. It requests the use of the memory address and data 
bus by sending a signal called HALT to the microprocessor, causing the 
processor to become "TRI-STATE" (open circuit) all during the next computer 
cycle. The ANTIC chip then takes over the address bus and reads any data 
it wishes from memory. Another name for this type of DMA is "cycle stealing". 
Once initiated, this DMA is completely and automatically controlled by the 
Antic chip without need for futher microprocessor intervention. 

There are two types of DMA; Playfield and Player-Missile (see Figure 
II. 2). The playfield DMA control circuit on the Antic chip resembles a 
small dumb microprocessor. By halting the main microprocessor it can 
fetch its own instructions from memory (the display list) addressed by its 
program counter(display list pointer). Each instruction defines the type 
(alpha character or memory map) , and the resolution (size of bits on the 
screen) , and the location of the data in memory which is to be displayed 
on the next group of lines. 
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In order to begin this DMA the main microprocessor must store a 
display list of instructions in memory, store data to be displayed in 
memory, tell the ANTIC where the display list is (initialize the display 
list pointer) and enable the DMA control flags on the ANTIC (DMACTL 
register) • 

In addition to the playfield DMA described above, the ANTIC 
chip simultaneously controls another DMA channel. This type of DMA 
addresses PLAYER-MISSILE graphics data stored in memory and passes the 
graphics data on to the CTIA chip graphics registers. This type of DMA 
(if enabled) occurs automatically, interspersed with the playfield DMA 
described previously. This PLAYER-MISSILE DMA has no display list or 
instructions, and is therefore much simpler than the PLAYFIELD DMA. 

In addition to the two types of display DMA, the ANTIC chip also 
generates DMA addresses for the refresh of the dynamic memory RAM used 
in this system. This is also completely automatic and need be consider- 
ed by the programmer only if he is concerned with real-time programming 
where an exact count of the computer cycles is important. 



Color- luminance : A color- luminance register is used on the CTIA chip 
for each Player-Missile and Playfield type. Each color-lum register is 
loaded by the microprocessor with a code representing the desired color 
and luminance of its corresponding Player-Missile or Playfield type. As 
the serial data passes through the CTIA chip it is "impressed" with the 
color and luminance values contained in these registers , before being sent 
to the TV display. In areas of the screen where there are no objects the 
background color (COLBK) is displayed. The CTIA also does collision 
detection (to be described later). 



Priority : When moving objects, such as players and missiles, 
overlap on the TV screen (with each other or with Playfield) a decision 
must be made as to which object shows in front of the other. Objects 
which appear to pass in front of others are said to have Priority over 
them. Priority is assigned to all objects by the CTIA chip before the 
serial data from each object is combined with the other objects and sent 
to the TV screen. 

The priority of objects can be controlled by the microprocessor by 
writing into the control register PRIOR. The functions of the bits in 
this register are given in the table in the PRIOR register description in 
section III. 



Players and Missiles : The players and missiles are small objects 
which can be moved quickly in the horizontal direction by changing their 
position registers. They are called players and missiles because they 
were originally designed to be used in games for objects such as airplanes 
and bullets. However, there are many other possible applications for 
them. The four player-missile color registers, in conjunction with the 
four playfield color registers and the background color register, make 
it possible to display 9 different colors at the same time. 



II. 3 



OBJECTS (no objects = background) 



\ i\ 



GRAPHICS 



PLAYFIELD 




MICRO 
PROCESSOR 



P^;.CV(GRACTL) 




MEMORY MAP 



CHARACTERS 



controlled by 
Display list 
instructions 



<^J> 



^^^y,-- Player 
tH ^#-*Missile 



a n 



DMA 
Enable 



MEMORY 



;^ (DMACTL) 

\ 

Playfield 
DMA Enable 



Figure II. 2 OBJECT DISPLAY SOURCES 



II. 4 



There are a total of four players and four missiles. The four 
missiles may be grouped together and used as a 5th player. These 
objects are positioned horizontally by 8 horizontal position registers 
(HPOS (X)). These registers may be reloaded at any time by the proces- 
sor, allowing an object to be replicated many times across a horizontal 
TV line. 

The shape of a player-missile is determined by the data in its 
graphics register (GRAF (X)). Players have independent 8 bit graphics 
registers. The four missiles have 2 bit registers (located within one 
address). These registers may also be reloaded at any time by the 
processor, although they are usually changed during horizontal blank 
time. The data in each graphics register is placed on the display 
whenever the horizontal sync counter equals the corresponding horizon- 
tal position register. The same data will be displayed every line unless 
the graphic registers are reloaded with new data. 

The player-missile graphic registers may be reloaded by the micro- 
processor (GRAF (X)), or automatically from memory with direct memory 
access (DMA) (see figure II. 3). The programmer must place the object 
graphics in memory, write the player-missile base address (PMBASE) , and 
enable player-missile DMA (DMACTL, GRACTL) . The transfer of object 
graphics from memory to display is then fully automatic. 

PMBASE specifies the most significant byte (MSB) of the address of 
the player-missile graphics. The location of the graphics for each 
object is determined by adding an offset to PMBASE *256 (decimal). The 
bytes between the base address and the missile data are not used by 
Antic, so they are available to the programmer. 

Only the five most significant bits of PMBASE are used with 
single-line resolution and the six most significant bits are used 
with two-line resolution. This means that the location of the graphics 
in memory is restricted to certain page boundaries. Two-line resolu- 
tion means that each byte of data is repeated for two lines. (see 
DMACTL, bit 4). 6A0 (decimal) bytes (5X128) are required for two-line 
resolution and 1280 bytes (5x256) for one-line resolution. 

Each byte in the player graphics area represents eight pixels which 
are to be displayed on the corresponding line(s) of the TV screen. A 
1 indicates that the player's color-lum is to be displayed in that pixel. 
The graphics may be anything, not just rectangles like the ones in figure 
II. 3. The player graphics may fill the entire height of the screen or 
they may be only a couple of lines high if the rest of the display data is 
all O's. Each byte in the missile display also represents eight pixels, 
two pixels for each missile. Each pixel may be 1, 2, or 4 color clocks, 
and is determined by the SIZE registers. 



Playfield ; Playfield is always generated by DMA. There are four 
playfields, each identified by its own color-lum register and collision 
detection. Playfield is generated by two different DMA techniques: 
memory map and character. Both methods provide lists of instructions in 
memory, independent of the player-missile generation. 
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Player-Missile Base Address (PMBASE) = MSB of address. 
Resolution is controlled by bit 4 of DMACTL. 



PMBASE*100(hex) 
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Horizontal position 
"for each object is set 
independently by 8 
horizontal position 
registers. 



Player-Missile 
Vertical screen 
map in memory 



Each section of memory maps directly 
onto total height of TV screen. 
Object vertical position is determined 
only by its location in its section 
of memory. One byte of memory equals 
1 or 2 television lines vertically. 



Figure II. 2 
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DMA 
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Unlike players and missiles, there are no horizontal position registers 
for playfield. Each player can only have one byte of display per line. 
Playfield, on the other hand, may require up to 48 bytes per line because 
it can fill the entire width of the screen. 

There are three different playfield widths: narrow (128 color 
clocks), standard (160 color clocks), and wide (192 color clocks). 
The width is selected by storing into DMACTL. The advantage of a narrower 
width is that less RAM is required and fewer machine cycles are stolen for 
DMA. The OS graphics modes use the standard screen width. 



Display List : The display list is a sequence of display instructions 
stored in memory. These instructions are either one (1) byte or three (3) 
bytes long. The display list can be considered a display program, and the 
Display List Counter that fetches these instructions can be thought of as 
a display program counter. (10 bit counter plus 6 bit base register.) 

The display list counter can be initialized by writing to DLISTH and 
DLISTL. (or OS shadow registers SDLSTH and SDLSTL). Once initialized 
this counter value is used to address the display list, fetch the instruc- 
tion, display one (1) to sixteen (16) lines of data on the TV screen, 
increment the Display List Counter, fetch the next display instruction, 
and so on automatically without microprocessor control (see DLISTL and 
DLISTH). DLISTL and DLISTH should be altered only during vertical blank 
or when DMA is disabled (see DMACTL). 

Each instruction defines the type (alpha character or memory map) and 
the resolution (size of bits on screen) and the location of data in memory 
to be displayed for a group (1 to 16) of lines. Each group of lines is 
called a display block. 

THE DISPLAY LIST CANNOT CROSS A IK BYTE MEMORY BOUNDARY UNLESS 
A JUMP INSTRUCTION IS USED. 



DLISTH (MSB) 



D7 |D6 |D5 |D4 |D3 |D2 |D1 |D0 



DLISTL (LSB) 
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Fixed (6 bits) Counter (10 bits) 

DISPLAY LIST COUNTER 
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Display Instruction Format : Each instruction consists of either an 
opcode only, or of an opcode followed by two (2) bytes of operand. 



jOpcodt 



•Single Byte Display Instruction 



lopcodel 

I Operandi > Triple Byte Display Instruction 



[Operand 

The opcode is always fetched first and placed in the Instruction 
Register * This opcode defines the type of instruction (1 or .3 bytes) 
and will cause two more bytes to be fetched if needed. If fetched, 
these next two (2) bytes will be placed in the Memory Scan Counter , 
or in the Display List Counter (if the instruction is a Jump). 



Display Instruction Register (IR) : This register is loaded with the 
opcode of the current display list instruction. It cannot be accessed 
directly by the programmer. There are three basic types of display list 
instructions: blank, jump, and display. 

Blank 

(1-byte) 



|D7lD6|D5|D4l Ol Ol 0\ 01 

This instruction is used to create 1 to 8 blank lines on the 
display (blackground color) . 

D7 1 = display list instruction interrupt 
D6 - D4 0-7 = 1-8 blank lines 
D3 - DO = blank 



Jump 
(3-bytes) 



Id7|D6| XI XI 01 01 01 ll 

This instruction is used to reload the Display List Counter. 
The next two bytes specify the address to be loaded (LSB first) 



display list instruction interrupt 

jump (creates one blank line on display) 

jump and wait until end of next vertical blank 

don't care 

jump 



D7 
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D6 
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D5-D4 


X 


D3-D0 


1 



Display 

(1 or 3 bytes) Id7 |D6 |D5 |D4 |D3 |D2 iDl IdO i 



This instruction specifies the type of display for the next 
display block. 



D7 
D6 



D5 
D4 
D3-D0 



1 = display list instruction interrupt 

0=1 byte instruction 

1=3 byte instruction (reload Memory Scan Counter 

using address in next two bytes, LSB first). 
1 = vertical scroll enable 
1 = horizontal scroll enable 
2-F = display mode (memory or character map - 
see following pages). 



II. 8 



HSCROL 


1 


Ixxl Ixxl Ixxl Ixxl 


Ixxl Ixxl Ixxl Ixxl 


VSCROL 


1 


1 Ixx Ixxl 1 Ixx Ixxl 


1 |xx|xx| 1 |xx|xx| 


LD MEM SCAN 


1 


1 1 1 1 XX 1 XX Ixx Ixxl 


1 1 1 |xx|xx|xx|xx| 



INST INTERRUPT 



I I I I I I I I XX I XX I XX I XX I XX I XX I XX I XX I 



Horizontal Scrolling 
Vertical Scrolling 
Load memory scan (3 byte) 
Display instruction interrupt 
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Blank 1 line 
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Character Mode 
Instruc t ions 



Memory Map Mode 
Instructions 



Number of TV lines per cell 

Number of Colors (Background + Playfield types) 

Number of Horizontal cells (standard width screen) 



Figure II. 3 
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Bit 7 of a display list instruction can be set to create a display 
list interrupt if bit 7 of NMIEN is set. The display list interrupt code 
can change the colors or graphics during the middle of the TV display. 
The type of interrupt is determined by checking NMIST. NMIRES clears 
NMIST. The current OS will vector through VDSLST (Hex 200 and 201) to 
the user's display list interrupt routine. See the OS manual for program- 
ming details. 

Bits 5 and 4 of a display type of display list instructions are used 
to enable vertical and horizontal scrolling. The amount of scrolling 
depends on the values in the VSCROL and HSCROL registers (to be described 
later) . 



Memory Scan Counter ; This counter is not directly accessible by the 
programmer. It is loaded with the value in the last 2 bytes of a 3 byte 
(non-Jump) instruction. 

This counter points to the location (address) in memory of data to be 
directly displayed (memory map display) or to the location of character 
name strings to be indirectly displayed (character display). 

A single byte instruction does not reload this counter. This implies 
a continuation in memory of data to be displayed from that displayed by 
the previous instruction. Since this counter really consists of 4 bits of 
register and 12 of actual counter, a continuous memory block cannot cross 
4K byte memory boundaries^ unless the counter is repositioned with a 3 
byte Load Memory Scan Counter instruction. 



MSB third byte of 3 byte 
byte instruction 



LSB Second byte of 3 
byte instruction 



r 



\ 



7 I 6 I 5 I 4 I 3 I 2 I 1 I 
V J 



-^r 



7I6I5I4I3I2I1I0 
V / 



Fixed (4 bits) 



Counter (12 bits) 



^ 



I i I I I I I I I I I I I I 
151 141 131 121 111 101 9 I 8 I 7 I 6 I 5 I 4 I 3 I 2 I 1 I 



Memory Map Display Instructions ; Data in memory (addressed by the 
Memory Scan Counter) is displayed directly when executing a memory (bit) 
map display instruction. As data is being displayed it is also stored in 
a shift register so that it can be redisplayed for as many TV lines as 
required by the instruction. 
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Memory Scan Counter 
Addresses each byte 




One line worth of memory is 
loaded into the shift register 



Shift 
Register 



Shift register data is displayed for four TV scan lines in this example. 



In Instruction Register (IR) display modes 8 through F, one or two 
bits of memory are used to specify what is to be displayed on each pixel 
of the screen. Pixel sizes range from 1/2 clock by 1 TV line to 4 clocks 
by 8 TV lines. The OS and BASIC support most of these graphics modes 
(BASIC GRAPHICS command). Two modes, C and E, are not supported by the 
OS. These modes have rectangular pixels, which are approximately twice as 
wide as they are high. 

In IR mode F, only one color (C0LPF2) can be displayed. Two different 
luminances are available. If a bit is a zero, then the luminance of the 
corresponding pixel comes from C0LPF2. If the bit is a one, them the 
luminance is determined by the contents of COLPFl (abbreviated to PFl). 

In IR modes 9,B, and C, two different colors can be displayed. A 
zero indicates background color and a one indicates PFO color. The 
difference between the various modes is in the size of the pixels. 

In IR modes 8,A,D, and E, two bits are used to specify the color 
of each pixel. This allows four different colors to be displayed. 
However, only four pixels can be packed into each byte, instead of eight 
as in the previous modes. The bit assignments are shown below. 



SHIFT REGISTER |7 6|5 413 ill 0|7 6|5 4|3 2|l 0| 



2 bits form 
one pixel 
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Memory Map Display Modes 
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Character Display Instructions ; The first step in using the character 
map mode is to create a character set in memory (or the built-in OS 
character set at hex EOOO may be used) • The character set contains eight 
bytes of data for the graphics for each character. The meaning of the 
data depends on the mode. The character set can contain 64 or 128 characters, 
also depending on the mode. The MSB (Most Significant Byte) of the 
address of the character set is stored in CHBASE (or the OS Shadow CHBAS). 
Only the most significant six or seven bits of CHBAS are used (see CHBASE 
description in section III). The other one or two bits and the LSB of the 
address are assumed to be zero, so the character set must start at an 
acceptable page boundary. 

The next step is to set up the display list for the desired mode. 
Then the actual display is set up. This consists of a string of character 
names or codes. Each name takes one byte. The last 6 or 7 bits of the 
name selects a character. For a 64 character set, the name would range 
from through 63 (decimal). For a 128 character set, the range would be 
through 127 (decimal). The upper one or two bits of the name byte are 
used to specify the color or other special information, depending on the 
mode. 

Character names (codes) are fetched by the memory scan counter, and 
are placed in a shift register. On any given line of display the shift 
register rotates, changing only the name portion of the character address, 
as shown below. 

After a full line of character data has been displayed the line 
counter will increment. The next line again addresses all characters by 
name for that line number. 

In 20 character per line modes the seven most significant bits of 
CHBASE are used. This recjuires that the character set to start upon a 512 
byte memory boundary. The set must contain 64 charcters, 8 bytes each, 
giving a total of 512 bytes for the set. 

The 40 character per line modes use the six most significant bits 
of CHBASE, forcing the character set to start on a IK byte memory boundary. 
The set must have 128 characters of 8 bytes each. This gives a total of 
1024 bytes for the set. 



Hex Graphics | Chars. | Number | Bytes | Number | Bytes | 
Code Mode | Per | of 1 per | of Char. | in | 

1 Line I Colors 1 Char. I in set 1 Char Set I 


2 1 40 1 2 1 8 1 128 1 1024 1 


3 - 1 40 1 2 1 8 1 128 1 1024 1 


4 - 1 40 1 4 1 8 1 128 1 1024 1 


5 - 1 40 1 4 1 8 1 128 1 1024 1 


6 1 1 20 1 5 1 8 1 64 1 512 1 


7 2 1 20 1 5 1 8 1 64 1 512 1 
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Character Display 

(20 Character per line mode example) 
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There are six charcter map modes, IR modes 2 through 7. Modes 2,6 
and 7 are supported by the OS and BASIC (GRAPHICS 0,1 and 2). 

In IR modes 6 and 7, the upper two bits of each character n ame select 
one of four playfield colors. For each data bit that contains a one, the 
selected playfield color is displayed. For each zero data bit, the 
background color is displayed. The four character colors plus the background 
color gives a total of five different colors, the mode 6 characters are 
eight lines high and the mode 7 characters are sixteen lines high (each 
data byte is displayed for two lines). 

In IR modes 4 and 5, each character is only four pixels wide instead 
of eight (as in the other modes) . Two bits per pixel of data are used to 
select one of three playfield colors, or background. Seven name bits are 
used to select the character. If the most significant name bit is a zero 
then data of 10 (binary) selects PFl. If the name bit 7 is one, then data 
bits of 10 select PF2. This makes it possible to display two characters 
with different colors, using the same data but different name bytes. 

In IR modes 2 and 3, each pixel is half of a color clock in width. 
This makes it possible to have forty eight-pixel-wide characters in a 
standard width line. These modes are similar to memory mode F in that two 
luminances can be displayed, but only one color is available at a time. 
In IR mode 3, each character is 10 lines high. This makes it possible to 
define lower case characters with descenders. The last fourth of the 
character set (name bits 5 and 6 equal to one) is lowered. The hardware 
takes the first two data bytes and moves them to the bottom of the character, 
displaying two blank lines at the top of the character (see next page). 

In IR modes 2 and 3, bit 7 of the character name is used for inverse 
video or blanking. This is controlled by CHACTL (Character Control). If 
bit 2 of CHACTL is a one then all of the characters will be displayed 
upside down, regardless of mode. If CHACTL bit 1 is set, then each 
character which has bit 7 of its name set will be displayed in inverse 
video (the luminances will be reversed). If CHACTL bit is set, then 
each character which has bit 7 set will be blanked (only background wil be 
displayed) . Characters can be blinked on and off by setting name bit 7 to 
1 and toggling CHACTL bit 0. Inverse video and blank apply only to IR 
modes 2 and 3. If both inverse video and blank are set then the character 
will appear as an inverse video blank character (solid square). 



Hardware Collision Detection : 60 bits of collision register are 
provided to detect and store overlap (hits) between players, missiles and 
playfield. These collisions can be read by the microprocessor from 
addresses DOOO through DOOF. There are no bits for missile to missile 
collisions. 

16 bits for Missile to Playfield 

16 bits for Player to Playfield 

16 bits for Missile to Player 

12 bits for Player to Player (PC to PC always reads as zero, etc.) 

The 1/2 clock memory map mode (IR code 1111) and the 1/2 clock Character 
mode (IR codes 0011 and 0010) are both playfield type 2 collisions and will 
be stored in bit 2 of the playfield collision registers. 
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IR Mode 3-Upper and Lower Case 
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Character Map Display Modes 
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Vertical and Horizontal Fine Scrolling : Playfield objects are difficult 
to move smoothly. Memory map playfield can be moved by rewriting sections 
of memory. However, this is extremely time-consuming if large sections 
of the screen must be moved smoothly. Character playfield objects can be 
moved easily in a jerky fashion by changing the memory scan counter. 
However, this results in a large position jump from one character position 
to another, not a smooth motion. For this reason hardware registers 
(VSCROL and HSCROL) and counters are provided to allow smooth horizontal 
or vertical motion, up to one character width horizontally and up to one 
character height vertically. After this much smooth motion has been 
done by increasing the value in these registers, memory is rewritten or 
the memory scan counter is modified and smooth motion is resumed for 
another character distance. 



Vertical Scrolling ; A zone of playfield on the screen can be scrolled 
upward by using VSCROL and bit 5 of the display list instruction. The 
display blocks at the upper and lower boundaries of the zone must have a 
variable vertical size. In particular, the first display block within that 
zone must be shortened from the top, and the last display block must be 
shortened from the bottom (i.e. not all of the top and bottom blocks will 
be displayed) . 

The vertical dimension of each display block is controlled by a 4 bit 
counter within the ANTIC, called the 'Delta Counter' (DCTR) . Without 
vertical scrolling, it starts at on the first line, and counts up to a 
standard value, determined by the current display instruction. (Ex: 
for upper and lower case text display, the end value is 9. For 5 color 
character displays, it is 7 or 15.) 

If bit 5 of the instruction remains unchanged between consecutive 
display blocks, then the second block is displayed in the normal fashion. 
If bit 5 of the instruction goes from 1 to between two consecutive 
display blocks, the second block will start with Delta = 0, as usual, but 
will count up until delta=VSCROL, instead of the standard value. This 
shortens that display block from the bottom. 

To define a vertically scrolled zone, the most direct method is to 
set bit 5 to 1 in the first display instruction for that zone, and in all 
consecutive blocks but the last one. If the VSCROL register is not 
rewrittren on the fly, this results in a total scrolled zone that has a 
constant number of lines (provided that the VSCROL value does not exceed 
the standard individual block size). If N is the standard block size, the 
top block will be N-VSCROL lines (N > VSCROL ), and the last block will be 
VSCROL + 1 lines: (N-VSCROL) + (VSCROL + 1) = N + 1. Shown on the 
following page is an example of a scrolled zone, top block, for 8 VSCROL 
values for N = 8. 

Horizontal scrolling is described under HSCROL in section III. 
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bit 5 




Simple Display List Example ; BASIC starts out in OS graphics mode 
which displays 40 characters across by 24 rows. This is IR mode 2 with a 
standard screen width. The OS sets up the display list near the top of 
ilAM with room for the character names at the top of RAM. On a 32 K-byte 
machine, the display list would start at hex 7C20. The next three bytes 
are hex 70' s to create 24 blank lines. The next byte is a hex 42. The 
4 tells the hardware to reload the memory scan counter with the following 
address (7C40). This is the address of the data to be displayed. The 2 
tells the hardware to display one line of IR mode 2 characters. The 
next 23 bytes specify 23 more lines of mode 2 characters. Hex 41 is the 
code for jumping and waiting until the end of the next vertical blank. 
The address to jump to is 7C20, the start of the display list. The next 
960 bytes are the list of characters to be displayed, 40 bytes per line. 
The OS must set up the display list pointer (DLISTH and DLISTL) to the 
starting address of the display list (7C20). It also sets CHBASE to the 
MSB of the address of the character set (EO) . 

This is a simple example because only one mode is used and the memory 

scan counter is only loaded at one point. It is possible to have different 

modes on different lines, change character sets and colors, etc., as shown 
in the example in Section IV. 
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OS Mode Display List (40 chars x 24 lines) 



Address (hex) 
7C20 



7C40 



Data (hex) 

24 blank lines 



70 
70 
70 
42 
40 
7C 

2 ^ 

2 

2 



} 



eload memory scan counter with 7C4C 
IR mode 2 



^ 23 more IR mode 2 instructions 



2 

2 

2 J 
41 *^ Jump back to 7C20 and 
20 ? wait for end of vertical blank. 
7C 



) 
) 



960 bytes of display data 
(character names) 



Cycle Counting ; As explained previously, the ATARI 800 6502 micropro- 
cessor runs at a rate of 114 machine cycles per TV line (1.79 MHZ). There 
are 262 lines per TV frame and 60 frames per second on the NTSC (I^S) system. 
(The PAL (Europeon) system is different. See the section on NTSC vs. PAL.) 

Each machine cycle is equivalent in length to 2 color clocks. There 
are 228 color clocks on a TV line. The highest resolution graphics modes 
have a pixel size of 1/2 color clock by 1 TV line. Horizontal blank takes 
40 machine cycles. This is when the beam returns to the left edge of the 
screen in preparation for displaying the next TV line. A wait for Sync 
(WSYNG) instruction stops the 6502. The processor is restarted exactly 7 
machine cycles before the beginning of the next TV line. The program can 
thus change graphics or colors during horizontal blank in preparation for 
the next line. 

The ANTIC chip steals cycles from the 6502 in order to do memory 
refresh and fetch graphics data when needed. The general rule to remember 
is that each byte fetched from memory requires one machine cycle. If a 
display list memory map instruction extends over several lines then the data 
is only fetched on the first line. Memory refresh takes 9 cycles out of 
every line, unless pre-empted by a high- resolution graphics mode. Memory 
refresh continues during vertical blank. 

Missile DMA takes one cycle per line in the one-line resolution mode 
and one cycle every 'other line in the two line resolution mode. Missile 
DMA can be enabled without doing player DMA. However, if player DMA is 
enabled then missile DMA will also be done (see DMACTL, GRACTL bits). 
Player DMA requires 4 cycles every one or two lines, depending on the 
resolution used. 
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Each fetch of a display list byte takes one cycle, so three cycles 
are required for a three byte instruction. 

Player/missile and display list instruction fetch DMA take place 
during horizontal blank, if they are required for the next line. 

In memory map modes, the graphics data is fetched as needed throughout 
the first line of the display list instruction, then saved by ANTIC for 
use in succeeding lines. In character modes, the character codes are 
fetched during the first line of each row of characters, along with the 
graphics data needed for that line. On the next lines, only the graphics 
data is fetched, since ANTIC remembers the character codes. 

In the 40 x 24 character mode, with a standard screen width, most of 
the cycles during the top line of each row of characters are requried to 
fetch the character codes and data, so there is only time for one memory 
refresh cycle instead of the usual nine. Less DMA is required with a narrow 
screen width so two memory refresh cycles would occur in this case. 

The memory refresh is done fast enough to make up for the lost cycles 
in the high resolution modes. Once memory refresh starts on a line, it 
occurs every four cycles unless pre-empted by DMA. 

All interrupts reach the 6502 near the end of horizontal blank. 
With standard or narrow screen widths, refresh DMA starts after the end of 
horizontal blank. 

The time at which ANTIC does cycle stealing is deterministic, but 
depends on the graphics mode, screen width and whether or not horizontal 
scrolling is enabled. Horizontal scrolling requires extra graphics data: 
see HSCROL. 

ANTIC does horizontal scrolling of an even number of color clocks by 
delaying the time at which it DMA's the data. To do an odd number of color 
clocks (which involves half of a machine cycle) , ANTIC has a one color clock 
internal delay. 

Theoretically, it is possible to write a program which changes graphics 
or colors "on the fly", i.e. during the middle of a TV line. However, 
with all the DMA going on, the cycle counting gets to be quite complicated, 
and is beyond the scope of this manual. 

There are a number of delays associated with the display of graphics. 
These occur in the ANTIC and the CTIA. The ANTIC sends data to the CITA 
which adds in the color information. Thus the timing for changing colors on 
the fly is different from that for changing graphics on the fly. 
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Horizontal Blank DMA Timing 



When DMA is enabled, cycles are stolen at the times shown below. 
End of 



H 



Previous_ 
Line 



Horizontal Blank 



20 machine cycles (40 color clocks) 



I 4 



I 1 I 1 I 



WSYNC 



I 2 I 



8 

A 



1-9 refresh cycles, 
char, and graphics 
data DMA (depends on 
graphic mode) 



^Interrupt 
Address DMA (3-byte display list 

instruction) 
Player 

Display list instruction fetch DMA 
Missile DMA 



Cycle Counting Example : This example uses the 40 character by 24 line 
display list given on page 11.24. This display list is 32 bytes long so 
display list DMA takes 32 machine cycles. It takes 960 cycles to DMA the 
characters and 8*960 to DMA the character data. The refresh DMA takes 9 
cycles for each of 262 lines, except for the 24 lines where the characters 
are read, where only 1 refresh cycle occurs. 



DMA description 
display list 
characters 
character data 
refresh 
total 



Machine 


cycles 




32 


40x24 


= 960 


960x8 


=7680 


262x9-24x8 


=2166 




10838 



Thus the total DMA per frame is 10838 machine cycles. One frame 
is 262 lines with 114 machine cycles per line for a total of 29868 machine 
cycles per frame. Thus 36% of each frame is required for DMA in OS graphics 
mode 0. 



NTSC vs. PAL Systems ; There are two versions of the ATARI 800: the NTSC 

(United States T.V. standard) and PAL (one of the European T.V. standards). 

The PAL system has been designed so that most programs will run without 

being modified. However, some differences may be noticeable. There is a 

hardware register (PAL) which a program can read to determine which type of 
system it is running on and adjust accordingly. 
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The PAL T.V. has a slower frame rate (50 Hz. instead of 60 Hz.) so 
games will be slower unless an adjustment is made. PAL has more T.V. 
lines per frame (312 instead of 262). The Atari 800 hardware compensates 
for this by adding extra lines at the beginning of vertical blank. Display 
lists do not have to be altered. However, their actual vertical height will 
be shorter. PAL ATARI 800 colors are similar to NTSC because of a hardware 
modification. 



B. POKEY 



Audio : There are 4 semi- independent audio channels, each with its own 
frequency, noise, and volume control. Each has an 8 bit "divide by N" 
frequency divider, controlled by an 8 bit register (AUDFX) . (See audio-serial 
port block diagram.) Each channel also has an 8 bit control register (AUDCX) 
which selects the noise (poly counter) content, and the volume. 



Frequency Dividers : All 4 frequency dividers can be clocked simultane- 
ously from 64 KHZ or 15 KHZ. (AUDCTL bit 0). Frequency dividers 1 and 3 
can alternately be clocked from 1.79 MHZ (AUDCTL bits 6 and 5). Dividers 2 
and 4 can alternately be clocked with the output of dividers 1 and 3 (AUDCTL 
bits 4 and 3). This allows the following options: 4 channels of 8 bits 
resolution, 2 channels of 16 bit resolution, or 1 channel of 16 bit and 2 
channels of 8 bit. 



Poly Noise Counters : There are 3 polynomial counters (17 bit, 5 bit 
and 4 bit) used to generate random noise. The 17 bit poly counter can be 
reduced to 9 bits (AUDCTL bit 7). These counters are all clocked by 1.79 
MHZ. Their outputs, however, can be sampled independently by the four 
audio channels at a rate determined by each channel's frequency divider. 
Thus each channel appears to contain separate poly counters (3 types) 
clocked at its own frequency. This poly counter noise sampling is controlled 
by bits 5,6 and 7 of each AUDCX register. Because the poly counters are 
sampled by the "divide by N" frequency divider, the output obviously cannot 
change faster than the sampling rate. In these modes (poly noise outputted) 
the dividers are therefore acting as "low pass" filter clocks, allowing only 
the low frequency noise to pass. 

The output of the noise control circuit described above consists of 
pure tones (square wave type) , or polynomial counter noise at a maximum 
frequency set by the "divide by N" counter (low pass clock). This output 
can be routed through a high pass filter if desired (AUDCTL bits 1 and 
2). 



11.23 



Audio Noise Filters : 
VOL 



Low Frequency 
Noise 



(Low pass noise cut off set 
by Divide by N counter. 



Frequency 



Any channel noise output (without high pass filter) 



VOL 



Channel 3l 
- by N J\ 



fchannel 1 
I- by N 






Channel 1 output (with high pass filter) 



VOL 



Channel 4 
(or 3 & 4) 
- by N 






Channel 2 
<(or 1 & 2) 
1^- by N 



Channel 2 output (with high pass filter) 



Clock 






Frequency 



Frequency 
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High Pass Filters ! The high pass filter consists of a "D" flip flop 
and an exclusive-OR Gate. The noise control circuit output is sampled by 
this flip flop at a rate set by the "High Pass" clock. The input and output 
of the Flip Flop pass through the exclusive-OR Gate. If the flip flop input 
is changing much faster than the clock rate, the signal will pass easily 
through the exclusive-OR Gate. However, if it is lower than the clock rate, 
the flip flop output will tend to follow the input and the two exclusive-OR 
Gate inputs will mostly be identical (11 or 00) giving very little output. 
This gives the effect of a crude high pass filter, passing noise whose 
minimum frequency is set by the high pass clock rate. Only channels 
1 and 2 have such a high pass filter. The high pass clock for channel 1 
comes from the channel 3 divider. The high pass clock for channel 2 comes 
from the channel 4 divider. This filter is included only if bit 1 or 2 of 
AUDCTL is true. 



Volume Control ; A volume control circuit is placed at the output of 
each channel. This is a crude 4 bit digital to analog converter that 
allows selection of one of 16 possible output current levels for a logic 
true audio input. A logic zero audio input to this volume circuit always 
gives an open circuit (zero current) output. The volume selection is 
controlled by bits thru 3 of AUDCX. "Volume Control only" mode can be 
invoked by forcing this circuit's audio input true with bit 4 of AUDCX. In 
this mode the dividers, noise counters, and filter circuits are all discon- 
nected from the channel output. Only the volume control bits (0 to 8 of 
AUDCX) determine the channel output current. 

The audio output of any channel can be completely turned off by writing 
zero to the volume control bits of AUDCX. All ones gives maximum volume. 



C. SERIAL PORT 



The serial port consists of a serial data output (transmission) 
line, a serial data input (receiver) line, a serial output clock line, a 
bi-directional serial data clock line, and other miscellaneous control lines 
described in the Operating System Manual. Data is transmitted and received 
as 8 bits of serial data preceded by a logic zero start bit, and succeeded 
by a logic true stop bit. Input and output clocks are equal to the baud 
(bit) rate, not 16 times baud rate. Transmitted data changes when the 
output clock goes true. Received data is sampled when the input clock goes 
to zero. 



Serial Output : The transmission sequence begins when the processor 
writes 8 bits of parallel data into the serial output register (SEROUT)(see 
audio and serial port block diagram) . When any previous data byte trans- 
mission is finished the hardware will automatically transfer new data from 
(SEROUT) to the output shift register, interrupt the processor to indicate 
an empty (SEROUT) register (ready to be reloaded with the next byte of 
data), and automatically serially transmit the shift register contents with 
start-stop bits attached. If the processor responds to the interrupt, and 
reloads SEROUT before the shift register is completely transmitted, the 
serial transmission will be smooth and continuous. 
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Output data is normally transmitted as logic levels (+4V=true OV=False) . 
Data can also be transmitted as two tone information. This mode is selected 
by bit 3 of SKCTL. In this mode audio channel 1 is transmitted in place of 
logic true, and audio channel 2 in place of logic zero. Channel 2 must be 
the lower tone of the tone pair. 

The processor can force the data output line to zero (or to audio 
channel 2, if in two tone mode) by setting bit 7 of SKCTL. This is required 
to force a break (10 zeros) code transmission. 



Serial Output Clock ; The serial output data always changes when the 
serial output clock goes true. The clock then returns to zero in the center 
of the output data bit time. 

The baud (bit) rate of the data and clock is determined by audio 

channel 4 audio channel 2, or by the input clock, depending on the serial 

mode selected by bits 4, 5, and 6 of SKCTL. (See chart at end of this 
section.) 



Serial Inpu t ; The receiving sequence begins when the hardware has 
received a complete 8 bit serial data word plus start and stop bits. This 
data is automatically transferred to the 8 bit parallel input register 
(SERIN), and the processor is interrupted to indicate an input data byte 
ready to read in SERIN. The processor must respond to this interrupt, and 
read SERIN, before the next input data word reception is complete, otherwise 
an input data "over-run" will occur. This over-run will be indicated by bit 
5 of SKSTAT (if bit 5 of IRQST is not RESET (true) before next input complete) , 
and means input data has been lost. This bit should be tested whenever 
SERIN is read. Bit 7 of SKSTAT should also be tested to detect frame errors 
caused by extra (or missing) data bits. 



pirect Serial Input : The serial data input line can be read directly 
by the microprocessor if desired, ignoring the shift register, by reading 
bit 4 of SKSTAT. 



Bi-Directional Clock : This clock line is used to either receive a 
clock from an external clock source for clocking transmitted or received 
data, or is used to supply a clock to external devices indicating the 
transmit or reception rate. This clock line direction is determined 
by the serial mode selected by bits 4, 5, and 6 of SKCTL. (See mode chart 
at the end of this section.) Transmitted data changes on the rising edge of 
this clock. Received data is sampled on the trailing edge of this clock. 



Asynchronous Serial Input ; Unclocked serial data (at an approximately 
known (+5%) rate) can be received in the asynchronous modes. The receive 
(input) shift register is clocked by audio channel 4. Channels 3 and 
4 should be used together (AUDCTL bit 3=1) for increased resolution. 
In asynchronous modes, channels 3 and 4 are reset by each start bit at the 
beginning of each serial data byte. This allows the serial data rate to be 
slightly different from the rate set by channels 3 and 4. 
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Serial Mode Control ; There are 6 useful modes (of the possible 8) 
controlled by bits 4, 5, and 6 of SKCTL. These are described on the next 
page. 

Note that two tone output (bit 3 of SKCTL) may be used in any of these 
modes except for the bottom pair. This is because channel 2 is used to set 
the output transmit rate and is therefore not available for one of the two 
tones. 

Note that the output clock rate is identical to the output data rate. 



Serial Mode Control (see also register description SKCTL) : 
Force Break 

D5|D4|D3|D2|D1|D0 T SKCTL REGISTER 

I 

I Pot scan and keyboard CTRL 



jD7iD6 



D6 



D5 



] [Out I Out I In I Bi-Dir 

D4 1 Rate I Clock! Rate| Clock 



I Two Tone Control 

I 

I Mode Control Bits 



A=asynchronous 



Comments 



|ext 

LJ 



ext 



ext 



ext 
input 



Trans. & Receive rates set by 
external clock. Also internal 
clock phase reset to zero. 



L 



L 



1 I ext 



ext 



L 



chan 
4 
A 



ext 
input 



Trans, rate set by external 
clock. Receive asynch. (ch. 4) 
(CH3 and CH4) 



L 



L 



L 



I chan 
1_4_ 



chan 
4 



chan 

Ut 



chan 

4 

output 



Trans. & Receive rates set by 
Chan. 4. Chan. 4 output on Bi- 
Directional clock line. 



L 



I I I I 



L 



L 



L 



1 |CH4 
I I A I 



CH4 
A 



CH4 



Not Useful 



input 



L_L 



L 



L 



I chan 
I 4 

J 



chan 
4 



ext 



ext 
input 



Trans. Rate Set by Chan. 4 
Receive Rate set by External 
Clock. 



LJ. 



L 



L 



1 |CH4 
I I A 



CH4 
A 



CH4 
A 



Not Useful 



input 



L 



LJ. 



L 



L 



L_L 



IChan 
I 2 

LJ 



Chan 
2 



Chan 
2 



L 



Chan 

4 

Output 



Trans, rate set by chan. 2 
Recieve rate set by chan. 4 Chan. 
4 out on Bi-Direct. Clock line. 



L 



LJ. 



L 



L 



1 I Chan 

I 2 

LJ L 



Chan 
2 



Chan 
4 
LA L 



Input 

not 

used 



Trans. Rate set by Chan. 2. Re- 
ceive async. (chan 3&4) Bi-Dir. 
Clock not used (Tri-state condi- 
tion) 



L 



Two tone (bit3) not useable in these modes 
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D. INTERRUPT SYSTEM 



There are two basic types of interrupts defined on the microprocessor: 
NMI (non maskable interrupt) and IRQ (interrupt request). It is recommended 
that a thorough understanding of these interrupt types be acquired by 
reading all chapters concerning interrupts in the 6502 microprocessor 
programming and hardware manuals. 

In this system NMI interrupts are used for video display and reset. 
IRQ interrupts are used for serial port communication, peripheral devices, 
timers, and keyboard inputs. 

NMI Interrupts : Even though NMI interrupts are "unmaskable" on 
the micrprocessor, this system has interrupt enable (mask) bits for NMI 
function. (Bits 6 and 7 of NMIEN) When these bits are zero NMI interrupts 
are disabled (masked) and prevented from causing a microprocessor NMI 
interrupt. (see NMIEN register description) The 3 types of NMI interrupts 
are: 

1. D7 = I n s t ru c t i on I n t e r ni p t (during display time any display 

instruction with bit 7=1 will cause this interrupt to occur 
(if enabled) at the start of the last video line displayed by 
that instruction.) 

2. D6 = Vertical Blank Interrupt (interrupt occurs (if enabled) at 

the beginning of the vertical blank time interval.) 

3. D5 = Reset Button Interrupt (pushing the SYSTEM RESET button will 

cause this interrupt to occur.) 

Since any of these interrupts will cause the processor to jump to the 
same NMI address, the system also has NMI status bits which may be examined 
by the processor to determine which source caused the NMI interrupt. Bits 
5, 6, and 7 of NMIST serve this function (see NMIST register description). 
These status bits are set by the corresponding interrupt function (even if 
the interrupt is masked from the processor by NMIEN). The status bits may 
be reset together by writing to the address NMIRES. 

Two of the interrupt enable bits (bits 6 and 7 of NMIEN) are cleared 
automatically during system power turn on and therefore these NMI interrupts 
are initially disabled (masked) , preventing any power turn on service routine 
from being interrupted before proper initialization of registers and pointers.* 
They can then be enabled by the processor whenever desired, by writing into 
bits 6 and 7 of NMIEN. Except for the reset button interrupt, they can also 
be disabled by the processor by writing a zero into bits 6 or 7 or NMIEN. 
The reset button cannot be disabled, allowing an unstoppable escape from any 
possible "hangup" condition. 

These NMI interrupt functions are each separated in time (to prevent 
overlaps) and converted to pulses by the system hardware, in order to supply 
NMI transitions required by the microprocessor logic. 



NOTE: Bit 5 is never disabled and therefore the Reset Button 
should not be pressed during power turn on. 
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IRQ Interrupts ; IRQ interrupts are all "maskable" together by one bit 
of the status register on the microprocessor. This bit is set to the 
disable condition automatically by power turn on to prevent interrupt of 
power turn on service routines.** In addition to this processor IRQ mask 
bit, there are separate system IRQ interrupt enable bits for each IRQ 
interrupt function (bits thru 7 of IRQEN). These bits are not initialized 
by power turn on, and must be initialized by the program before enabling the 
processor IRQ. The 8 types of IRQ interrupts are: 

D7 = BREAK KEY (depression of the break key) 
D6 = OTHER KEY (depression of any other key) 
D5 = SERIAL INPUT READY (Byte of serial data has been received and is 

ready to be read by the processor in SERIN register) . 
D4 = SERIAL OUTPUT NEEDED (Byte of serial data is being transmitted and 

SEROUT is ready to be written to again by the processor) . 
D3 = TRANSMISSION FINISHED (serial data transmission is finished. 

Output shift register is empty) . 
D2 = TIMER #4 (audio divider #4 has counted down to zero) 
Dl = TIMER #2 (audio divider #2 has counted down to zero) 
DO = TIMER #1 (audio divider iH has counted down to zero) 

In addition to the above IRQ interrupts (enabled by bits through 7 of 
IRQEN and identified by status bits thru 7 of IRQST) there are two more 
system IRQ interrupts which are generated over the serial bus Proceed and 
Interrupt lines. 

D7 of PACTL = peripheral "A" interrupt status bit 

DO of PACTL = peripheral "A" interrupt enable bit 

D7 of PBCTL = peripheral "B" interrupt status bit 

DO of PBCTL = peripheral "B" interrupt enable bit 

These last two interrupts are automatically disabled by power turn on, 
and their status bits are reset by reading from port A register and port B 
register. (See PORTA, PACTL, PORTB, and PBCTL Register descriptions.) 

The IRQEN register, like the NMIEN register, enables interrupts 
when its bits are 1 (logic true). The IRQST however (unlike the NMIST) has 
interrupt status bits that are normally logic true, and go to zero to 
indicate an interrupt request. The IRQST status bits are returned to logic 
true only by writing a zero into the corresponding IRQEN bit. This will 
disable the interrrupt and simultaneously set the interrupt status bit to 
one. Bit 3 of IRQST is not a latch and does not get reset by interrupt 
disable. It is zero when the serial out is empty (out finished) and true 
when it is not. 



** - NOTE: An NMI also disables the I bit 
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INTERRUPT SUMMARY 



I NAME I FUNCTIONS 



ENABLE 



STATUS 



I STATUS 
I RESET 



NMI 
INTERRUPTS 



[Reset Button 



Display 
Instruction 



Vert. Blank 



NMIEN 
(Bits 6 thru 7) 
Normally Zero 
(Disabled) 



NMIST 
(Bits 5 thru 7) 
Normally Zero 
Cno interrupt) 



Address 
NMIRES 
(Resets all NMI 
st atus together) 



KEYS 
Serial 
ports 
Timers 



L 



IRQEN 
(Bits thru 7) 
zero is 
(Disabled)* 



IRQST 
(Bits thru 7) 
Normally True 
(no interrupt) 



IRQ 
INTERRUPTS 



Reset (to true) 
By Zero in 
Corresponding 
Bit of IRQEN 
I (except Bit 3)* 



Peripheral 
A 



DO of PACTL 
Normally Zero 
I (Disabled) 



D7 of PACTL 
Normally Zero 
(no interrupt) 



Reset by 
Reading PORT A 
Register 



Peripheral 
B 



DO of PBCTL 
Normally Zero 
I (Disabled) 



D7 of PBCTL 
Normally Zero 



Reset by 
Reading PORT B 



Cno interrupt) | Register 



E. CONTROLLERS 



A variety of controllers can be plugged into the four jacks on the 
front of the console. This includes joysticks, paddle (pot), twelve-key 
keyboard, and light pen (when available). 

The controller ports are read through the PORTA and PORTB regisers 
and the POT and TRIG registers. The OS reads these registers during 
vertical blank and stores into its own RAM locations. These are STICK, 
PADDLO through PADDL7, PTRIG'S and STRIG'S. The OS sets up PORTA AND 
PORTB for input. This is done by setting PACTL or PORTB (Port Control) 
bit 2 to a (to select the direction control register) , then writing all 
O's to the desired port. PACTL (PBCTL) bit 2 is then changed back to 
a 1, allowing the program to read from the port. The ports can also be 
set up for output by writing I's instead of O's while the direction control 
mode is selected. 



Joy-Sticks ; The joysticks have four switches, one each for right (R) , 
left (L), back (B) and forward (F) . 

These switches are read through PORTA and PORTB. A fifth switch is 
activated by pressing the red trigger button. The trigger buttons are 
read from TRIGO through TRIG3. A value of indicates that a button has 
been pressed and a 1 indicates that it has not been pressed. 
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The TRIG registers are normally read directly, but they can be used 
in a latched mode. Writing a zero to bit 2 of GRACTL disables the latches 
and sets them to 1. Writing a 1 to bit 2 enables the latches. If a joy- 
stick trigger button is pushed at any time while bit 2 of GRACTL is 1 
the latch value will change to zero and stay that way. A program can 
use this to determine whether the joystick trigger buttons have ever been 
pressed during a certain period of time. 



Paddles ; The paddles come in pairs, so eight paddles can be connected 
to the four jacks. The paddles are read by storing into POTGO, then 
reading the POT registers at least 228 lines later. The values range from 
(with the paddle turned to the right) to 228 (paddle turned counter-clockwise) 
The value indicates how many TV lines it takes to charge up the capacitor 
which is the series with the potentiometer. Turning the knob to the right 
lowers the resistance, so the capacitor charges up quickly. Turning the 
knob to the left increases the resistance and the charging time. The 
capacitor dump transistors are used to discharge the capacitors so that a 
new reading can be mode. The POTGO command clears the counters and turns 
off the dump transistors to allow the capacitors to charge up. The ALLPOT 
register contains one bit for each paddle. When the capacitor has charged 
up to the threshold value the ALLPOT bit changes fron one to zero and the 
POT register contains the correct readings. Bit 2 of SKCTL (Serial Port 
Control) enables fast pot scan. In this mode. It takes only two scan lines 
to charge up the capacitors to the maximum level instead of 228 lines. Bit 
2 is first set to to dump the capacitors. Then Bit 2 is set to 1 to start 
the pot scan. The fast pot scan is not as accurate as the normal scan mode. 
Bit 2 of SKCTL must be set to to use normal scan mode. Otherwise, the 
capacitors will never dump. Note that some paddles have a range smaller 
than to 228 due to differences in the pots. The left and right paddle 
triggers for each paddle pair are read from the left and right bits for the 
corresponding joystick (PORTA or PORTB) . 



Keyboard Controllers : Each keyboard controller has a twelve-key pad 
and plugs into a joystick controller port. The first step in using the 
keyboard is to select a row by setting the port direction to output and 
writing a to the bit in the PORTA or PORTB register which selects the 
desired row (see PORTA, SECTION III). The other rows should have I's 
written to them. Columns are read through the POT and TRIG registers (see 
controller PORT PINOUT chart in section III). Appendix H of the BASIC 
Reference Manual contains a Basic program which reads the controllers. The 
first and second columns of the keyboard use the same pins as the pots for 
the paddle controllers, so they are read by reading the POT (or PADDL) 
registers. When a button is pushed, the pot line is grounded, so the pot 
capacitors never charge up to the threshold level and the reading is 228 
(the maximum). When the button in the selected row and column is not pushed 
the capacitor is connected to +5V through a relatively small resistor, 
giving a POT value of about 2 (this may vary). Since the reading is not 
critical, the fast pot scan mode can be used, so that only a 2 line wait is 
required between selecting the row and reading the POT register. The 
convention has been adopted of comparing the POT reading with 10 (decimal) . 
If is it greater than 10 then the button has been pressed. The third 
column is read through the joystick trigger line, so it works just like a 
joystick trigger (O^button is pressed, l=not pressed). 
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Light Pen ; A light pen is a device that can detect the electron beam 
as it sweeps across the TV screen. It is used to point directly at an image 
on the TV display. Applications include selecting menu items and drawing 
lines. The ATARI 400/800 hardware was designed so that a light pen can be 
plugged into any of the joystick controller ports (see end of section 
III). 

When any one of the joystick trigger lines (pin 6) is pulled low, the 
ANTIC chip takes the current VCOUNT value and stores it in PENV. The 
horizontal color clock value (0-227 decimal) is stored in PENH. The least 
significant bit is inaccurate and should be ignored. Since there are a 
number of delays involved in displaying the data and changing the light 
pen register, each system must be cal brated. Software which uses the 
light pen should contain a user-interactive calibration routine. For 
example, the user could point the light pen at a crosshair in the center 
of the screen and the program could compute the required horizontal offset. 
PENH will wrap around from 227 to near the right hand edge of a standard 
width display because of the delay. The pen will not work if it is pointed 
at a black area of the screen, since the electron beam is turned off. It is 
a good idea to read two (or more) values and average them, since the user 
will probably not hold the pen perfectly steady. 
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III. HARDWARE REGISTERS 



This section lists the hardware registers and Operating System (OS) 
shadow registers. 

In the following descriptions, true always refers to a bit whose value 
is 1. 



A. PAL (D014) 



Not 




1 D3 


1 D2 


1 Dl |Not 




Used 




1 




1 lUsed 




D3 


D2 


Dl 








1 


1 


1 




NTSC (US TV) 













PAL (European TV) 



This byte can be read by a program to determine which type of system 
the program is running on. 



B. INTERRUPT CONTROL 



NMIEN (Non Maskable Interrupt Enable) (D40E) : This address writes data 
to the NMI interrupt enable bits. 

= disabled (masked) 

1 = enabled 



I I Not 

D7 I D6 I Used 



D7 Display List Instruction Interrupt Enable. This bit is 

cleared by Power Reset, and may be set or cleared by the 
processor. 

D6 Vertical Blank Interrupt Enable. This bit is cleared by Power 
Reset, and may be set or cleared by the processor. 

SYSTEM RESET Button Interrupt 

This interrupt is always enabled. The SYSTEM RESET button should 
not be pressed during power turn on. 

(Set to hex 40 by OS IRQ code.) 



III.l 



NMIST (Non Maskable Interrupt Status) (D40F) ; This address read the NMI 
Status Register (Read by OS NMI code) . 

= no interrupt 

1 = interrupt 



III Not 
D7 I D6 I D5 I Used 



D7 This bit identifies an NMI interrupt caused by bit 7 of a 
Display List Instruction. 

D6 This bit identifies an NMI interrupt caused by the beginning 
of vertical blank. 

D5 This bit identifies an NMI interrupt caused by the SYSTEM 
RESET button. 



NMIRES ( NMI Status Register Reset) (D40F) t This write address resets 
the Non Maskable Interrupt Status Register (NMIST) . 



Not 
Used 



( Written by OS NMI code.) 

IRQST (IRQ Interrupt Status) (D20E) ; This address reads the data from 
the IRQ Interrupt Status Register. 

= Interrupt 

1 = No Interrupt 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



D7 = Break Key Interrupt 

D6 = Other Key Interrupt 

D5 = Serial Input Data Ready Interrupt 

D4 = Serial Output Data Needed Interrupt 

D3 = Serial Output (Byte) Transmission Finished Interrupt * 

D2 = Timer 4 Interrupt 

Dl = Timer 2 Interrupt 

DO = Timer 1 Interrupt 



* - NOTE: Used for generation of 2 stop bits. See IRQ description 
in section II (no direct reset on bit 3). 
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IRQEN (IRQ Interrupt Enable) (D20E) ; This address writes data to the IRQ 
Interrupt Enable bits. 

= disable, corresponding IRQST bit is set to 1 

1 = enable 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



D7 Break Key Interrupt Enable 

D6 Other Key Interrupt Enable 

D5 Serial Input Data Ready Interrupt Enable 

D4 Serial Output Data Needed Interrupt Enable 

D3 Serial Out Transmission Finished Interrupt Enable 

D2 Timer 4 Interrupt Enable 

Dl Timer 2 Interrupt Enable 

DO Timer 1 Interrupt Enable 

OS SHADOW: POKMSK (hex 10) 

Use AND's and OR's to change one bit in POKMSK without affecting 
the others. Store the desired value in both IRQEN and POKMSK. 



C. TV LINE CONTROL 



VCOUNT (Vertical Counter) (D40B) ; This address reads the Vertical TV 
Line Counter (8 most significant bits) . 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 

VO not read. 

V8 V7 V6 V5 V4 V3 V2 VI VO Two line 

resolution 
supplied. 



WSYNC (Wait for Horizontal Blank Synchronism - i.e. wait until start of 
next TV line. ) (D40A) ; 



not used 



This address sets a latch that pulls down on the RDY line to the 
microprocessor, causing it to wait until this latch is automatically reset 
by the beginning of horizontal blank. Display list interrupts may be 
delayed by 1 line if WSYNC is used. (Used by OS keyboard click routine.) 
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D. GRAPHICS CONTROL 



DMACTL (Direct Memory Access Control) (D400) ; This address writes data 
into the DMA Control Register. 



Not I I I I I I 
Used I D5 I D4 I D3 I D2 I Dl I DO 



D5 = 1 Enable instruction fetch DMA 

D4 = 1 1 Line P/M resolution 

D4 = 2 line P/M resolution 

D3 = 1 Enable Player DMA 

D2 = 1 Enable Missile DMA 

D1,D0 = No Playfield DMA 

=01 Narrow Playfield DMA 
(128 Color Clocks) 

=10 Standard Playfield DMA 
(160 Color Clocks) 

= 1 1 Wide Playfield DMA 
(192 Color Clocks) 

See GRACTL. OS Shadow: SDMCTL (22F) default value hex 22 



GRACTL (Graphics Control) (DOID) : This address writes data to the 
Graphic Control Register. 



Not III 

Used I D2 I Dl I DO 



D2 = 1 Enable latches on TRIGO - TRIG3 inputs (latches are 

cleared and TRIGO - TRIGS act as normal inputs when this 
control bit is zero) . 

Dl = 1 Enable Player DMA to Player Graphics Registers. 

DO = 1 Enable Missile DMA to Missile Graphics Registers. 

DMA is enabled by setting bits in both DMACTL and GRACTL. Setting 
DMACTL only will result in cycles being stolen but no display will be 
generated. 
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CHACTL (Character Contro l) (D401) ; This address writes data into the 
Character Control Register. 



Not 
Used 



D2 I Dl 



DO 



D2 Character Vertical Reflect Bit. This bit is sampled at the 
beginning of each line of characters. If true it causes the 
line of characters to reflect (invert) vertically (for upside 
down characters). 

Dl Character Video Invert Flag (used for 40 Character Mode 

only) . If bit 7 of character code is true this flag causes 
that character to be blue on white (if normal colors are 
white on blue) . 

DO Character Blank (Blink) Flag (used for 40 Character Mode 

only) . If bit 7 of character code is true this flag causes 
that character to blank. Blinking characters are produced by 
setting bit 7 of the characters to 1, then periodically 
changing DO of CHACTL. 



OS SHADOW: CHACT (2F3) 



DLISTL( Display List Low )(D402); This address writes data into the 
low byte of the Display List Counter. 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 
7 6 5 4 3 2 10 

OS SHADOW: SDLSTL (hex 230) 



^Display 
J List 
< Counter 
I Bit 
V^Position. 



DLISTH (Display List High)(D403) ; This address writes data into the 
high byte of the Display List Counter. 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



15 14 13 12 11 10 



OS SHADOW: SDLSTH (HEX 231) 



Display 
List 
Counter 
Bit 
^Position. 



The Display List is a list of display instructions in memory. These 
instructions are addressed by the Display List Counter. Loading these 
registers defines the address of the beginning of the Display List. (See 
sections I and II.) 

Note: The top 6 bits are latches only and have no count capability, therefore 
the display list can not cross a IK byte memory boundary unless a jump 
instruction is used. 
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DLISTL and DLISTH should be changed only during vertical blank or with 
DMA disabled. Otherwise, the screen may roll. Bit 7 of NMIEN must be set 
in order to receive display list interrupts. 



CHBASE (Character Address Base Register) (D409) ; This address writes 
data into the Character Address Base Register. The data specifies the most 
significant byte (MSB) of the address of the desired character set (see 
section II). Note that the last 1 or 2 bits are assumed to be 0. 



40 Character Modes 
|p7 |D6 |D5 |D4 |D3 |D2 J * I CHBASE 



115 114 lis 112 111 110 I 9 I 8 I 7 I 6 I 5 I 4 I 3 I 2 I 1 I oH 
^ .>^^ A. " ^ , /\ ^ ^ 7 



Base Address Char Name Line Counter 

20 Character Modes 



|D7 |D6 |D5 |D4 |D3 |D2 |D1 j"^ CHBASE 









■ 






\ 
















[15 


114 


|13 


|12 


111 


|10 


9 1 8 


7 


6 


5 


4 


3 2 


1 1 1 





<s 












vv 






.^^' '" 




X 


— ^N-<— 





Base Address Char Name Line Counter 

OS SHADOW: CHBAS (2F4) 



PMBASE (Player-Missile Address Base Register) (D407) ; This address 
writes data into the Player-Missile Address Base Register. The data 
specifies the MSB of the address of the player and missile DMA data (see 
section II) . 



One Line Resolution 
|D7 |D6 |D5 |D4 |D3 I not used 



PMBASE 



Z' \ 



il5 114 113 112 ill UP I 9 I 8 J 7 |6|5|4|3|2|1|~ 



Base Address Player-Missile Player-Missile Scan 

Select Counters 

Two Line Resolution 

PMBASE 



D7 |D6 |D5 |D4 |D3 |D2 | 



::\ 



15 114 113 112 111 no I 9 I 8 I 7 J 6 I 5 I 4 I 3 I 2 I 1 I 



Base Address Player-Missile Player-Missile Scan 

Select Counter 



* = Not Used 
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HSCROL (Horizontal Scroll Register) (D404) : This address vnrites data 
into the Horizontal Scroll Register. Only playfield is scrolled, not 
players and missiles. 



not used I I I I 
i D3 I D2 i Dl I DO 



to 15 color 
clock right shifts 

The display is shifted to the right by the number of color clocks 
specified by HSCROL for each display list instruction that contains a 1 in 
its HSCROL Flag bit (bit 4 of instruction byte). 

When horizontal scrolling is enabled, more bytes of data are needed. 
For a narrow playfield (see DMACTL bits 1 and 0) there should be the same 
number of bytes per line as for standard playfield with no scrolling. 
Similarly, for standard playfield use the same number of bytes as for the 
wide playfield. For wide playfield, there is no change in the number of 
bytes and background color is shifted in. 



VSCROL (Vertical Scroll Register) (D405) ; This address writes data into 
the Vertical Scroll Register. 



not used | | | 
{ D2 I Dl I DO 



8 line display modes 



not used 



I D3 I D2 I Dl I DO 



16 line display modes 



The display is scrolled upward by the number of lines specified in 
the VSCROL register for each display list instruction that contains a 1 in 
its VSCROL Flag bit (bit 5 of instruction byte). The scrolled area will 
terminate with the first instruction having a zero in bit 5. (see section 
II for more details). 



PRIOR (Priority) (DOIB) ; This address writes data into the Priority 
Control Register. 



I I I I I I I 
D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



D7-D6 = D5 

Multiple Color Player Enable. 

This bit causes the logical "or" function of the bits of 
the colors of Player with Player 1, and also of Player 2 
with Player 3. This permits overlapping the position of 2 
players with a choice of 3 colors in the overlapped region. 
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D4 Fifth Player Enable . 

This bit causes all missiles to assume the color of Playfield 
Type 3. (C0LPF3) . This allows missiles to be positioned 
together with a common color for use as a fifth player. 

D3, D2, Dl, Priority Select (Mutually Exclusive). 

& DO These bits select one of 4 types of priority. Objects with 

higher priority will appear to move in front of objects 

with lower priority. 



D3=l 



D2=l 



Dl=l 



D0=1 



Higher 
Priority 



pPFO 
l-PFl 
PO' 
PI 
P2 
P3- 
I — PF2 
|PF3 + P5 
BAK 



PFO 

PFl 

PF2 
PF3 + P5 

PO" 

PI 

P2 

P3_J 

BAK 



PC 

P 
— PFO 

PFl 

PF2 
PF3 + 5 

P2 

P3 

BAK 



'C~~l 
l-J 



] 



PO - 

PI 

P2 
, _ P3 _ 

PFO 

FFl 

PF2 
PF3 + 5 

BAK 



NOTE: The use of Priority bits in a "non-exclusive" mode (more than 1 

bit true) will result in objects (whose priorities are in conflict) 
turning BLACK in the overlap region. 
EXAMPLE; PRIOR code = 1010 This will black PO or PI if they are over 

PFO or PFl. It will also black P2 or P3 if they are over PF2 or 
PF3. In the one-color 40 character modes, the luminance of a 
pixel in a character is determined by COLPFl, regardless of the 
priority. If a higher priority player or missile overlaps the 
character then the color is determined by the player's color. 

OS SHADOW: GPRIOR (26F) 



COLPFO - C0LPF3 (Playfield Color) (D016, D017, D018, D019) ; These 
addresses write data to the Playfield Color-Lum Registers. 



D7 I D6 I D5 I D4 I D3 I D2 i Dl I DO 



(see COLBK for bit assignment) 
OS SHADOWS: COLORO - 3 (2C4-2C7) 
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COLBK (Background Color) (DOIA) ; This address writes data to the 
Background Color-Lum Register. 





Co 


lor 




Luminance 








1 




1 1 


Not 


D7 


D6 


1 D5 


D4 


D3 1 D2 1 Dl 


Used 


X 


X 


X 


X 




1 
ETC. 

1 1 1 


Z 

^ 














Grey 













1 


Gold 








1 





Orange 








1 


1 


Red-Orange 





1 








Pink 





1 





1 


Purple 





1 


1 





Purple-Blue 





1 


1 


1 


Blue 













Blue 










1 


Light-Blue 







1 





Turquoise 







1 


1 


Green-Blue 




1 








Green 




1 





1 


Yellow-Green 




1 


1 





Orange-Green 




1 


1 


1 


Light-Orange 





Zero Luminance (black) 



Max. Luminance (white) 



OS SHADOW: COLOR 4 (2C8) 



E. PLAYERS AND MISSILES 

DMACTL, GRACTL, PMBASE and PRIOR also affect players and missiles. 

COLPMO - C0LPM3 (Player-Missile Color) (D012, D013, D014> D015 ) : These 
addresses write to the Player-Missile Color-Lum Registers. Missiles have 
the same color-lum as their player unless missiles are used as a 5th player 
(see bit 4 of PRIOR). A 5th player missile gets its color from C0LPF3. 



D7 



D6 I D5 I D4 I D3 I D2 I Dl I DO 



(see COLBK for bit assignments) 

OS SHADOWS: PCOLRO - 3 (2C0-2C3) 

GRAFPO - GRAFP3 (Player Graphics Registers); (PO DOOD, PI DOPE. P2 DOOF , 
?_3 DOlO) : These addresses write data directly into the Player Graphics 
Registers, independent of DMA. If DMA is enabled then the graphics registers 
will be loaded automatically from the memory area specified by PMBASE (see 
page II. 3) . 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



Left 



Player on TV Screen 



Right 
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GRAFM (Missile Graphics Registers) (DOll) ; This address writes data 
directly into the Missile Graphics Register, independent of DMA. 



D7 I D6 



R 



D5 I D4 



D3 I D2 



R 



R 



I 
Dl I DO 



R 



M3 



M2 



Ml 



MO 



SIZEPO - SIZEP3 (Player Size) (PO D008, PI D009, P2 DOOA, P3 DOOB) ; 
These addresses write data into the Player Size Control Registers. 

Horizontal Size 
Register (Player) 



Not 
Used 


Dl 


DO 












1 


1 





1 


1 



Normal Size 

(8 color clocks wide) 
Twice Normal Size 

(16 color clocks wide) 
Normal Size 

4 Times Normal Size 
(32 color clocks wide) 



With normal size objects, each bit in the graphics register corresponds 
to one color clock. For larger objects, each bit is extended over more than 
one color clock. 



SIZEM (Missile Size)(DOOC) ; This address writes data into the Missile 
Size Control Register. 



D7 I D6 



D5 I D4 



D3 I D2 



M3 



M2 



Ml 



Dl 



MO 



DO 



Horizontal Size 
Register (Missile) 









Normal Size 
(2 color clocks wide) 





1 


Twice Normal Size 
(4 color clocks wide) 


1 





Normal Size 


1 


1 


4 Times Normal Size 



(8 color clocks wide) 



HPOSPO - HP0SP3 (Player Horizontal Position) (PO DOOO, PI DOOl, P2 D002, 
P3 D003) ; These addresses write data into the Player Horizontal Position 
Register (see display diagram in section IV). The horizontal positon value 
determines the color clock location of the left edge of the object. Hex 30 
is the left edge of a standard width screen. Hex DO is the right edge of a 
standard screen. 



D7 I D6 I D5 I D4 I D3 I D2 I Dl 



DO 
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HPOSMO - HP0SM3 (Missile Horizontal Position) (MO D004, Ml D005, 
M2 D006, M3 D007) ; These addresses write data into the Missile Horizontal 
Position Registers (see HPOSPO description). 



I I I I I I I 
D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



VDELAY (Vertical Delay) (DOIC) ; This address writes data into the 
Vertical Delay Register. 



I I I I I I I 
D7 I D6 i D5 I D4 I D3 I D2 I Dl I DO 



P3 P2 PI PO M3 M2 Ml MO 

VDELAY is used to give one-line resolution in the vertical po- 
sitioning of an object when the 2-line resolution display is enabled. 
Setting a bit in VDELAY to 1 moves the corresponding object down by one 
TV line. 

If player-missile DMA is enabled then changing the vertical location 
of an object by more than one line is accomplished by moving bits around 
in the memory map. If DMA is disabled then the vertical location can be 
set up by assembly language code which stores data into the graphics 
registers at the desired line. 

MOPF, MIPF, M2PF, M3PF (Missile to Playfield Collisions) (DOOO, DOOl, 
D002, D003) ; These addresses read Missile to Playfield Collisions. 
A 1 bit means that a collision has been detected since the last HITCLR. 



Not Used till 
(zero forced) j D3 I D2 | Dl | DO 



3 2 10 Playfield Type 

POPF> PIPF, P2PF, P3PF (Player to Playfield Collisions) (D004, 
D005, D006, D007) ; These addresses read Player to Playfield Collisions, 



Not Used I I I I 
(zero forced) I D3 I D2 I Dl I DO 



3 2 10 Playfield Type 

MOPL. MIPL, M2PL. M3PL (Missile to Player Collision) (D008, D009, 
DOOA, DOOB) : These addresses read Missile to Player Collisions. 



Not Used I I I I 
(zero forced) | D3 I D2 | Dl | DO 



3 2 10 Player Number 

POPL> PIPL, P "PL, P3P L (Player to Player Collisions) (DOOC, DOOD, DOOE , 
DOOF) ; These addresses read Player to Player Collisions 



Not Used I I II 
(zero forced) I D3 I D2 | Dl I DO 



3 2 10 Player Number 
(Player against Player is always a zero). Etc. 
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HITCLR (Collision "HIT" Clear) 



DOIE 



This write address clears all collision bits described 
above. 



Not 
Used 



F. AUDIO 

AUDCTL (Audio Control) (D208) : This address writes data into the Audio 
Mode Control Register. (Also see SKCTL two-tone bit 3 and notes). 



D7 I D6 I D5 I D4 I D3 I D2 I Dl 



DO 



D7 Change 17 bit poly into a 9 bit below poly. 

D6 Clock Channel 1 with 1.79 MHZ, instead of 64 KHZ. 

D5 Clock Channel 3 with 1.79 MHZ, instead of 64 KHZ. 

D4 Clock Channel 2 with Channel 1, instead of 64 KHZ (16 BIT). 

D3 Clock Channel 4 with Channel 3, instead of 64 KHZ (16 BIT). 

D2 Insert Hi Pass Filter in Channel 1, clocked by Channel 3. 

(See section II.) 

Dl Insert Hi Pass Filter in Channel 2, clocked by Channel 4. 

DO Change Normal 64 KHZ frequency, into 15 KHZ. 



Exact Frequencies ; The frequencies given above are approximate. The 
Exact Frequency (fin) that clocks the divide by N counters is given below 
(NTSC only, PAL different). 



FIN 


FIN 


(Approximate) 


(Exact) 


1.79 MHZ 


1.78979 MHZ 


64 KHZ 


63.9210 KHZ 


15 KHZ 


15.6999 KHZ 



Use modified formula for fout 



- Use normal formula for fout 



The Normal Formula for output frequency is: 



Fout = Fin/2N 



Where N = The binary number in the frequency register (AUDF) , plus 1 (N=AUDF+1). 
The MODIFIED FORMULA should be used when Fin =1.79 MHZ and a more exact result 
is desired: 



Fout = 



Fin 



2 (AUDF + M) 



Where:. M = 4 if 8 bit counter (AUDCTL bit 3 or 4 = 0) 
M = 7 if 16 bit counter (AUDCTL bit 3 or 4 = 1) 
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AUDFU AUDF2, AUDF3, AUDF4 (Audio Frequency) (D200, D202, D204, D206) 
These addresses write data into each of the four Audio Frequency Control 
Registers. Each register controls a divide by "N" counter. 



D7 


1 
I D6 


1 
1 D5 


1 1 
1 D4 1 D3 


1 

1 D2 


1 

1 Dl 


1 
1 DO 


"N" 





1 





1 





1 






ETC. 

1 1 





1 





1 



1 

1 


1 


2 


256 



Note: "N" is one greater 
than the binary number 
in Audio Frequency 
Register AUDF(X). 



AUDCl, AUDC2, AUDC3, AUDC4 (Audio Channel Control) (D201 . D2Q3. 
D205, D207): These addresses write data into each of the four Audio Control 
Registers. Each Register controls the noise content and volume of the 
corresponding Audio Channel. 



Noise Content 


or Distortion 


Volume 


















1 




Divisor "N" set 


HEX 


D7 


D6 


D5 


D4 


D3 


D2 1 Dl 


DO 


by audio frequency 























register. 

- 17 BIT poly - 5 BIT 


2 








1 











poly - N 
- 5 BIT poly - N - 2 


4 





1 














- 4 BIT poly - 5 BIT 


6 





1 


1 











poly - N 
- 5 BIT poly - N ~ 2 


8 


1 

















- 17 BIT poly - N 


A 


1 


X 


1 











- Pure Tone - N - 2 


C 


1 


1 














- 4 BIT poly - N 


1 


X 


X 


X 


1 








- Force Output 
(Volume only) 






















- Lowest Volume (Off) 


8 










1 








- Half Volume 


F 










1 


1 1 


1 


- Highest Volume 
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PITCH VALUES FOR THE MUSICAL NOTES-AUDCTL =0, AUDC = hex AX 

AUDF 

Hex Dec 

HIGH C ID 29 

NOTES B IF 31 

A# or Bb 21 33 

A 23 35 

G# or Ab 25 37 

G 28 40 

F# or Gb 2A 42 

F 2D 45 

E 2F 47 

D# or Eb 32 50 

D 35 53 

C# or Db 39 57 

C 3C 60 

B 40 64 

A# or Bb 44 68 

A 48 72 

G# or Ab 4C 76 

G 51 81 

F# or Gb 55 85 

F 5B 91 

E 60 96 

D# or Eb 66 102 

D 6C 108 

C# or Db 72 114 

MIDDLE C C 79 121 

B 80 128 

A# or Bb 88 136 

A 90 144 

G# or Ab 99 153 

G A2 162 

F# or Gb AD 173 

F B6 182 

E CI 193 

D# or Eb CC 204 

D D9 217 

LOW C# or Db E6 230 

NOTES C F3 243 



STIMER (Start Timer) (D209) : This write address resets all audio 
frequency dividers to their "AUDF" value. These dividers generate timer 
interrupts when they count down to zero (if enabled by IRQEN) . (also see 



IRQST) 



not used 



RANDOM (Random Number Generator) (D20A) : This address reads the high 
order 8 bits of a 17 bit polynomial counter (9 bit, if bit 7 of AUDCTL=1). 



I I i I I I I 
D7 1 D6 I D5 I D4 I D3 I D2 I Dl I DO 
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G. KEYBOARD AND SPEAKER 



CONSOL (Console Switch Port)(D01F) ; This address reads or writes data 
from the console switches and indicators. (Set to 8 by OS Vertical Blank 
code.) 



Not Used I I I I 
(zero forced) I D3 I D2 I Dl I DO 



Hex 08 should be written to this address before reading the switches 
Ones written will pull down on the switch line. 
CONSOL Bit Assignment: 



DO Game Start 

Dl Game Select 

D2 Option Select 

D3 Loudspeaker 



- means switch pressed. 

- should be held at 1 
except when writing 
momentarily. OS writes a 
1 during vertical blank. 



KBCODE (Keyboard Code)(D209) : This address reads the Keyboard Code, 
and is usually read in response to a Keyboard Interrupt (IRQ and bits 6 or 7 
of IRQST). See IRQEN for information on enabling keyboard interrupts. See 
SKCTL bits 1 and for key scan and debounce enable. 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



D7 = Control Key 
D6 = Shift Key 

Read by OS into shadow CH when key is hit. The OS has a get character 
function which converts the keycode to ATASCII (Atari ASCII). 
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KEYCODE TO ATASCII CONVERSION 



KEY 


KEY 










KEY 


KEY 








CODE 


CAP 


L.C. 


U.C. 


CTRL 




CODE 


CAP 


L.C. 


U.C. 


CTRL 


00 


L 


6C 


4C 


OC 




20 


) 


2C 


5B 


00 


01 


J 


6A 


4A 


OA 




21 


SPACE 


20 


20 


20 


02 


> 


3B 


3A 


7B 




22 


• 


2E 


5D 


60 


03 












23 


N 


6E 


4E 


OE 


04 












24 










05 


K 


6B 


4B 


OB 




25 


M 


6D 


4D 


OD 


06 


+ 


2B 


5C 


IE 




26 


/ 


2F 


3F 




07 


* 


2A 


5E 


IF 




27 


A 


* 


* 


■k 


08 





6F 


4F 


OF 




28 


R 


72 


52 


12 


09 












29 










OA 


F 


70 


50 


10 




2A 


E 


65 


45 


05 


OB 


U 


75 


55 


15 




2B 


Y 


79 


59 


19 


OC 


RET 


9B 


9B 


9B 




2C 


TAB 


7F 


9F 


9E 


OD 


I 


69 


49 


09 




2D 


T 


74 


54 


14 


OE 


- 


2D 


5F 


IC 




2E 


W 


77 


57 


17 


OF 


= 


3D 


7C 


ID 




2F 


Q 


71 


51 


11 


10 


V 


76 


56 


16 




30 


9 


39 


28 




11 












31 










12 


C 


63 


43 


03 




32 





30 


29 




13 












33 


7 


37 


27 




14 












34 


BACKS 


7E 


9C 


FE 


15 


B 


62 


42 


02 




35 


8 


38 


40 




16 


X 


78 


58 


18 




36 


< 


3C 


7D 


7D 


17 


Z 


7A 


5A 


lA 




37 


> 


3E 


9D 


FF 


18 


4 


34 


24 






38 


F 


66 


46 


06 


19 












39 


H 


68 


48 


08 


lA 


3 


33 


23 


* 




3A 


D 


64 


44 


04 


IB 


6 


36 


26 






3B 










IC 


ESC 


IB 


IB 


IB 




3C 


CAPS 


* 


* 


* 


ID 


5 


35 


25 






3D 


G 


67 


47 


07 


IE 


2 


32 


22 


FD 




3E 


S 


73 


53 


13 


IF 


1 


31 


21 


* 




3F 


A 


61 


41 


01 



* = 



special handling 
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H. SERIAL PORT (see peripheral connector on console) 



SKCTL (Serial Port control) (D20F) ; This address writes data into the 
register that controls the configuation of the serial port, and also the 
Fast Pot Scan and Keyboard Enable. 

(Bits are normally zero 
and perforin the functions 
shown below when true.) 



D7 I D6 I D5 I DA I D3 I D2 I Dl I DO 



D7 Force Break (force serial output to zero (space))* 



D6 
D5 
D4 

D3 



) 



D2 

Dl 
DO 



Serial Port Mode Control (see mode chart at end of 
Serial port description, page 11.34). 

Two Tone (Serial output transmitted as two tone signal instead of 
logic true/false.) 

Fast Pot (Fast Pot Scan. The Pot Scan Counter completes its 
sequence in two TV line times instead of one frame time. The 
capacitor dump transistors are completely disabled.) 

Enable Key Scan (Enables Keyboard Scanning circuit) 

Enable Debounce (Enables Keyboard Debounce circuits) 



DO-Dl (Both Zero) Initialize (State used for testing and initializing 
chip) ** 

OS SHADOW: SSKCTL (hex 232) 

The OS enables key scan and debounce and may change the other bits for 
different I/O operations. In particular, an aborted cassette operation may 
leave the two tone bit in the true state, causing undesirable audio signals. 
This may be corrected by writing hex 13 to both SKCTL and SSKCTL after doing 
I/O and/or before modifying the audio registers. 



* NOTE; 



**NOTE: 



When powered on, serial port output may stay low even if this bit 
is cleared. To get S.P. high (mark), send a byte out (recommend 
00 or FF). 

There is no original power on state. Pokey has no reset pin. 
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SKSTAT (Serial Port-Keyboard St atus) (D20F) ; This address reads the 
status register giving information about the serial port and keyboard. 



I I I I I I I 
D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



(Bits are normally true 
and provide the following 
information when zero.) 



D7 = = Serial Data Input Frame Error 

D6 = = Serial Data Input Over-run 

D5 = = Keyboard Over-run 

D4 = = Direct from Serial Input Port 

D3 = = Shift Key Depressed 

D2 = = Last Key is Still Depressed 

Dl = = Serial Input Shift Register Busy 

DO = 1 Not Used (Logic True) 



Latches 
must be 
reset = 1 
(SKRES) 

(D5 and D6 are set to 
zero when new data 
and same bit of IRQST 
is zero) 



SKRES, X^^^^^- -^^Q"^^ Status Reg^ister) CD20A) ; This write address resets 
bits 7, 6, and 5 of the Serial Port-Keyboard Status Register to 1. 



not used 



SERIN (Serial Input Data)(D20D) ; This address reads the 8 bit parallel 
holding register that is loaded when a full byte of serial input data has 
been received. This address is usually read in response to a serial data in 
interrupt (IRQ and bit 5 of IRQST). Also see IRQEN. 



D7 


1 
1 D6 


1 
1 D5 


D4 


1 
1 D3 


1 1 
1 D2 1 


Dl 


1 
1 DO 




Seria 


il I/O 


Port 


Connector 


Pinout: 






/ 














' 2 
o 


4 
o 


6 8 
o o 


10 
o 


'i\ 



1. 

3. 

5. 

7. 

9. 
11. 
13. 



o o o o o o 

1 3 5 7 9 11 13 



Clock In 

Data In to computer 

Data Ou t of Computer 

Command 

Proceed 

Audio In 



Interrupt 



2. 


Clock Out 


4. 


GND 


6. 


GND 


8. 


Motor Control 


10. 


+5 / Ready 


12. 


+12 



See serial port description in OS manual for more details 
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SEROUT (Serial Output Data)(D20D): This address writes to the 8 bit 
parallel holding register that is transferred to the output serial shift 
register when a full byte of serial output data has been transmitted. This 
address is usually written in response to a serial data out interrupt (IRQ 
and bit 4 of IRQST) . 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



I. CONTROLLER PORTS (front of console) 



PORTA (Port A)(D300) : This address reads or writes data from Player 
and Player 1 controller jacks if bit 2 of PACTL is true. This address 
writes to the direction control register if bit 2 of PACTL is zero. I/O for 
both ports (A and B) goes through a 6520/6820 

Data Register-Addressed if bit 2 of PACTL is 1. 

Joystick Operation 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



Right 



Back 



Right 



Back 



V- 



Left 



Fwd.. 



y V- 



Left 



Fwd. 



Stickl 
(Jack 2) 



StickO 
(Jack 1) 



0=Switch pressed 
l=Switch not pressed 



Paddle Operation 



D7 I D6 I D5 I D4 I D3 I D2 I Dl 



DO 



PTRIG2 
PTRIG3 



PTRIGO 
PTRIGl 



0=Switch pressed 
l=Switch not pressed 



Keyboard Controller Operation 



D7 I D6 I D5 I D4 I D3 I D2 I Dl [ DO 



Top Row 
2nd Row 
3rd Row 
4th Row 



Top Row 
2nd Row 
3rd Row 
4rd Row 



Jack 2 



Jack 1 



Direction Control Register-Addressed if b it 2 of PBCTL is 



I 
D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



Each bit corresponds to a jack pin 

0=input 
l=output 

OS SHADOWS: STICKO (hex 278), STICKl (279), PTRIGO-3 (27C-27F 
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PACTL (Port A Control) (D302) ; 
the Port A Control Register. 



This address writes or reads data from 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 







X 



X 



Port A Control 

Register 
Set up register as shown 
(X = described below) 



D7 - (Read only ) Peripheral A Interrupt Status Bit. Serial 

bus Proceed line. (Reset by reading Port A Register. 

Set by Peripheral A Interrupt.) 
D3 - Peripheral Motor Control line on serial bus (write) . 

(0 = On 1 = Off) 
D2 - Controls Port A addressing described above (write) • 

(1 = Port A Register = Direction Control Register). 
DO - Peripheral A Interrupt Enable Bit. (Write) 1 = Enable. 

Reset by power turn-on or processor. Set by Processor. 



PORTB ( Port B)(D301) : This address reads or writes data from Player 2 
and Player 3 controller jacks if bit 2 of PBCTL is true. This address 
writes to the direction control register if bit 2 of PBCTL is zero. I/O for 
both ports (A and B) goes through a 6520/6820. 

Data Register-Addressed if bit 2 of PBCTL is 1 



Joystick Operation 



D7 


1 
1 D6 


1 
1 D5 


D4 


1 
1 D3 


1 

D2 1 Dl 


DO 


Right 

1 
V 


Left 


Back 


Fwd 


Right 

Vv 


Back 
Left 


Fwd. 




Stick3 
(Jack 4) 






Stick2 
(Jack 3) 





0=Switch pressed 
l=Switch not pressed 







Paddle Operation 


D7 


1 1 1 1 1 1 1 
1 D6 1 D5 1 D4 1 D3 I D2 1 Dl 1 DO 




' — PTRIG6 
1 PTRIG7 


•--PTRIG4 
1 PTRIG5 



0=Switch pressed 
l=Switch not pressed 



Keyboard Controller Operation 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



Top Row^ 

2nd Row I 

3rd Row I 

4th Row^' 



Top Row'^ 
2nd Row V 
3rd Row / 
4rd Row J 



Jack 3 



Jack 4 
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Direction Control Register-Addressed if b it 2 of PBCTL is 



D7 I D6 I D5 I D4 I D3 I D2 I Dl 



DO 



Each bit corresponds to a jack pin 

0=input 
l=output 

OS SHADOWS: STICK2 (hex 27A), STICKS (27B), PTRIG4-7 (280-283) 



PBCTL (Port B Control) (D303) : 
the Port B Control Register. 



This address writes or reads data from 







Read Only 








D7 


1 
1 D6 


1 1 i 
1 D5 1 D4 1 


1 
D3 I D2 


1 

1 Dl 


1 

1 DO 



X 



X 



X 



Port B Control 

Register 
Set up register as 
shown (X=Described 
below) 



D7 

D3 
D2 
DO 



(Read only ) Peripheral B Interrupt Status Bit. Serial 

bus Interrupt line. Reset by Reading Port B Register. 

Set by Peripheral B Interrupt. 

Peripheral Command Identification. Serial bus Command 

Line. 

Controls Port B addressing described above. 

(1= Port B Register = Direction Control Register) 

Peripheral B Interrupt Enable Bit. 1 = Enable. 

Reset by power turn-on or processor. Set by processor. 

(Set to hex 3C by OS IRQ code) 



POTO - P0T7 (Pot Values) (D200-D207) : These addresses read the value 
to 228) of 8 pots (paddle controllers) connected to the 8 lines pot port. 
The paddle controllers are numbered from left to right when facing the 
console keyboard. Turning the paddle knob clockwise results in decreasing 
pot values. The values are valid only after 228 TV lines following the 
"POTGO" command described below or after ALLPOT changes. 



(0 



D7 I D6 I D5 I D4 I D3 1 D2 I Dl I DO 
Each Pot Value (0-228) 



OS SHADOWS: PADDLO - 7 (hex 270-277) 
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ALLPOT (All Pot Lines Simultaneously) (D208) ; This address reads the 
present state of the 8 line pot port. 

Capacitor dump transitors must be turned off by either going to fast 
pot scan mode (bit 2 of SKCTL) or starting pot scan (POTGO). 



I I I I I I I 
D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



Pot number: 
7 6 5 



4 3 2 1 
8 Pot Line States 



= Pot register value is valid. 

1 = Pot register value is not valid. 



POTGO (Start Pot Scan) (D20B) 



No 
Data Bits Used 



This write address starts the pot scan sequence. The pot values 
(POTO - P0T7) should be read first. This write strobe is then used causing 
the following sequence. 

1. Scan Counter cleared to zero. 

2. Capacitor dump transistors turned off. 

3. Scan Counter begins counting. 

4. Counter value captured in each of 8 registers (POTO - 
P0T7) as each pot line crosses trigger voltage. 

5. Counter reaches 228, capacitor dump transistors turned 
on. 



(Written to by OS vertical blank code) 



TRIGG, TRIGl, TRIG2, TRIG3 (Trigger Ports) (0 DOlO, 1 DOU, 2_ D012^ 
3 D013) ; These addresses read port pins normally connected to the joystick 
controller trigger buttons. 



Not Used 
(Zero Forced) 



DO 



= button pressed 

1 = button not pressed 



OS SHADOWS: STRIGO-3 (hex 284-287) 



NOTE: TRIGO thru TRIG3 are normally read directly by the microprocessor. 
However, if bit 2 of GRACTL is 1, these inputs are latched whenever 
they go to logic zero. These latches are reset (true) when bit 2 
of GRACTL is set to 0. 
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PENH (Light Pen Horizontal Color Clock Position) (D40C) : This address 
reads the Horizontal Light Pen Register (based on the horizontal color clock 
counter in hardware). The values range from to decimal 227. Wraparound 
occurs when the pen if near the right edge of a standard-width screen. PENH 
and PENV are modified when any of the joystick trigger lines is pulled low. 



D7 



D6 I D5 I D4 I D3 I D2 I Dl I DO 



H7 H6 H5 H4 H3 H2 
OS SHADOW: LPENH (hex 234) 



HI HO 



PENV (Light Pen Vertical TV Line Position) (D40D) ; This address reads 
the Vertical Light Pen Register (8 most significant bits, same as VCOUNT). 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 
LPS 7 6 5 4 3 2 1 

OS SHADOW: LPENV (hex 235) 



LPO not read. Two line 
resolution supplied. 



Front Panel (Controller) Jacks as l/O Parts: 

PIA (6520/6820) 

Out: TTL levels, 1 load 
In : TTL levels, 1 load 



Port A Circuit (typical): 




6520 (A) 


220 >v-/V, 


Port 




.001 




T 

epical) : 
0+5 
4.7K 


Port B Circuit (t^ 


6520 (B) 


220 /v>vVA 


Port 




.001 

• 




rcuit (typical) 


"Trigger" Port Cii 


CTIA Trig 


220 a/\Aa, 






.001 




T 



Jack 



Jack 



Jack 
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Controller Port Pinout: 







Male 
(console) 


Female 
(connector) 






\I 2 


3 4 5/ 


\ 5 4 3 


^ 1/ 






W 


7 8 9/ 


\ 9 8 


7 6 / 
















PIN 


JOYSTICK 


Controllers 
PADDLE (POT) 


KEYBOARD 


HARDWARE 
REGISTERS 


OS 
VARIABLES 


1 


Forward 




Top Row* 


Bit or 4** 


Bit 0*** 


2 


Back 




2nd Row* 


Bit 1 or 5** 


Bit 1*** 


3 

4 
5 


Left 
Right 


A(Left)Trigger 
B(Right)Trigger 
POT B (Right) 


3rd Row* 
Bottom Row* 
1st Column 


Bit 2 or 6** 
Bit 3 or 7** 
POT 1,3,5,7 


PTRIG0,2,4,6 
Bit 2*** 
PTRIG1,3,5,7 
Bit 3*** 
PADDL1,3,5,7 


6 


Trigger Button 




3rd Column 


TRIGG, 1,2, 3 


STRIGO, 1,2,3 


7 




+5 


+5 






8 


GND 


GND 








9 




POTA (Left) 


2nd Column 


POT 0,2,4,6 


PADDL0,2,4,6 



* Write 
** PORTA or PORTB 
*** STICK 0, 1, 2 or 3 
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IV. SAMPLE PROGRAM 



This assembly language program illustrates the use of players, missiles, 
and display lists. The diagram on the next page shows what the display 
looks like and which objects are used. The comments in the program listing 
describe how it works. 
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CHECKERS DISPLAY 



< 



TV LINES 
AFTER 
START OF 
DISPLAY 



Color Clocks- 
16 32 (decimal) 



-> 



168 



192 




^End of Vertical Blank 



24 Blank Lines 

20 Characters across by 8 lines high 
-I fi II II II II II II 



8 Rows 
Vl6 Characters across by 16 lines high 



16 Characters across by 8 lines high 



Player/ 
Missiles 



^ 


i 


Ml 


PO 


M2 




M3 




38 


3C 


^ 





PI 



5C 



P2 



7C 



P3 MO 



9C 



■v^ 



BC 



Player/Missile Horizontal Position 
Register Values (hex) • 



0000 



il 



TITLE "BTHPI 800 CHFCKt f---, (•I'r.H.HV HV f 



HHW Z/?l^'ft0" 



< 

(-0 



D409 
D400 
022F 
D000 
D008 
02C0 
0220 
0231 
D01D 
D407 
026F 

0200 

D40E 



0080 

0041 
0040 
0020 

0010 
0001 
0000 
0010 

0020 
0030 

0040 
0050 

00e0 

0070 



20 ;COPVRIQHT RTflRI 1980 

40 ; 

50 /THIS IS RN FXHMPLE OF H DISPLftV LIST WHICH USE.S CHRPHCTtR MRPPIMO TO 

60 , PRODUCE THE CHECKERS RND THE TOP RNC) BOTTOM BORDERS OF THE BORRD. 

70 ;PLRVERS RRE USED FOR THE RED SQURRES. THIS GIVES 6 COLORS WITHOUT 

80 ;CHRNGING THE COLOR REGISTERS. 

90 .MISSILES RRE USED FOP THE LEFT RtiD RIGHT BORC-ERS 

0100 ,THE PROGRRri STRRTS RT THE L.OCRTION SPECIFIED BV PtIB. 

^110 .R FEW TRICKS RRE USED TO SRVE PHM. BUT FURTHER OPTIMIZRTIOM IS POSSIBLE 

0120 .THIS IS fi RRM BRSED PROGRRfl WHICH RUNS WITH THE RSSEMBLER CRRTRIDGE> NOT R 

0120 ; ROM CARTRIDGE 

0140 ; 

0150 ; COLLEEN <RTRRI 800 > EQURTES 

0160 ; 

0170 CHBRSE = *D409 

0180 DMRCTL = *D400 

0190 SDMCTL = *022F 

0200 HPOSP0 = *D000 

0210 SI2EP0 = *D008 

0220 PCOLR0 = S02C0 

0230 SDLSTL = ♦0220 

0240 SDLSTH = *0221 

0250 GRRCTL = *D01D 

0260 PMBflSE = »D407 

0270 QPRIOR = *026F 

0280 VDSLST = *0200 

0290 NMIEN = *D40E 

0300 



0210 
0220 
0220 INT 
0240 JMPWT 
0250 RELOAD 
0360 VSC 
0270 HSC 
0280 JUMP 
0290 BLRNKl 
0400 BLRNK2 
0410 BLRNK2 
0420 BLRNK4 
0430 BLRNK5 
0440 BLRNK6 
0450 BLRNK7 
0460 BLRNK8 



DISPLAY LIST EQURTES 



♦80 
♦41 

♦ 40 
♦20 
♦10 
1 


♦10 

♦ 20 
♦20 

♦ 40 
*50 
♦60 
♦70 



DISPLRV LIST INTERRUPT <BIT 7 OF NMI STATUS > 

JUMP AND WRIT UNTIL END OF NEXT VERTICAL BLRNK C2 BYTES) 

RELOAD MEM SCAN COUNTER <2 BYTES > 

VERTICRL SCROLL ENABLE 

HORIZONTAL SCROLL ENABLE 

JUMP INSTRUCTION <:2 BYTES) 

1 BLANK TV LINE 

2 BLANK LINES 
2 

4 
5 
6 
7 
8 BLRNK TV LINES 



OTflRI 800 CHECKERS DISPLfiV BV C. SHOW 3/31/80 



0000 


0470 




PRGE 




0480 


i 






0020 


0490 
0500 


INTOFF 


= 


$20 ; 




0510 


; INTERNAL 


CHflRHCTER COD 




0520 








0000 


0530 


SPI 


= 


' -INTOFF 


0021 


0540 


fil 


= 


'fl- INTOFF 


0023 


0550 


CI 


= 


'C- INTOFF 


0024 


0560 


DI 


= 


■ 'D- 1 NT OFF 


0025 


0570 


EI 


= 


'E- INTOFF 


0027 


0580 


GI 


= 


'G- INTOFF 


0028 


0590 


HI 


= 


"H- INTOFF 


l-j 0029 
"^ 002F 


0600 


II 


s 


'I-INTOFF 


0610 


01 


= 


'0- INTOFF 


^ 0030 


0620 


PI 


= 


'P- INTOFF 


9032 


0630 


RI 


= 


'R- INTOFF 


9034 


0640 


TI 


= 


'T- INTOFF 


0039 


0650 


VI 


= 


'V- INTOFF 


0011 


0660 


Nil 


= 


'1- INTOFF 


0018 


0670 


N8I 


= 


'8-INTOFF 


0019 


0680 


N9I 


= 


'9- INTOFF 


0010 


0690 
0700 


N0I 


= 


'©-INTOFF 




0710 


i CHECKERS 


EQUATES 




0720 










0730 


i CODES 


FOR SPECIAL CHEC 




0740 








0000 


0750 


EMPTV 


= 


i 


0001 


0760 


CHECKER= 


1 i 


0002 


0770 


KING 


= 


2 


0003 


0780 


CURS 


= 


3 ; 


0004 


0790 
0800 


BORDER 


= 


4 ; 


0000 


0810 


CLP0 


= 


i 


0080 


0820 


CLPl 


= 


*80 ; 


90C0 


0830 


CLBOR 


= 


«C0 ) 


5000 


0840 


PMB 


= 


*5000 ; 



; USED TO GET INTERNAL CODE FOR UPPER CASE ALPHANUMERICS 



EMPTV SQUARE 
ORDINARV CHECKER 

CURSOR <X> 

USED FOR TOP AND BOTTOM BORDERS OF BOARD 

PLAVER < HUMAN > 

PLAVER 1 < COMPUTER > 

BORDER COLOR <USED TO SET UP 2 MSB'S OF CHAR) 

PLAVER MISSILE BASE ADDRESS & PROGRAM LOCATION 



OTflRl 800 CHECKERS DlSPLftV BV C. SHAM 3/31/80 



0Goe 

5000 

5020 



5021 
5180 
5200 
5280 
5200 
5380 

5400 
5414 
5424 
54fl4 



0850 
0860 
0370 
0880 
0890 
0900 
0910 
0920 
0920 
0940 
0950 
0960 
0970 
0980 
0990 
1000 
1010 
1020 
1030 
1040 
1050 
1060 



PRQE 

; PRtI VFiRlHBLES 



BOFIRD 
T0 



PMB 
*+22 



; CHECKER BORRD (ONLV 32 BLOCK SQUHRES ORE USED> 
; TEMP FOR MOVING BORRD TO MEM MRP 



;PLRVER RND MISSILE GRfiPHICS. 
;PLRVERS RRE USED FOR SQURRES 



MISSILES FOR LEFT RND RIGHT BORDERS 



*= 
QRM03 *= 
GRP0 ♦= 
QRPl *= 
GRP2 *= 
GRP2 *= 



PMB+«180 

♦+J80 

*+*80 

♦+*80 

*+»80 

*+»80 



TITL ♦= *+20 

TOPBRD *= ♦+16 

BRDSP ♦= 8*16+* 

BOTBRD ♦= *+16 



; MISSILE GRAPHICS 
;PLflVER GRRPHICS 
; PLRVER 1 
2 
; 3 

; TOP LINE OF CHARS — flTRSCII 
; TOP BORDER OF BOARD 
; BORRD DISPLRV 
; BOTTOM BORDER 



MESSAGE 



I— I 
I 
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< 

On 



54B4 



54B4 

5600 00 

5601 00 

5602 00 

5603 00 

5604 00 

5605 00 

5606 00 

5607 00 

5608 3C 

5609 7E 
560fl FF 
560B FF 
560C FF 
560D FF 
560E 7E 
560F 3C 

5610 2C 

5611 7E 

5612 flS 

5613 R5 

5614 C2 

5615 C3 

5616 7E 

5617 3C 

5618 C3 

5619 66 
561fl 3C 
561B 18 
561C 18 
561D 3C 
561E 66 
561F C3 

5620 00 
5521 FF 

5622 FF 

5623 FF 

5624 FF 

5625 FF 

5626 FF 

5627 00 



1070 
1080 ; 
1(190 ; GP 
1100 . 
1110 
1120 GR 
1130 



PRQE 

SPECIRL CHFCKEPS CHRPfiCTER SET 'T.OrJLV CODES 0-4 RPE USED. 

*= PMB+*600 

. BVTE 0.0,0.0,0.0.0.0 ; BLRNK <0> 



1140 



BVTE *2C. *7E. *FF. *FF. *FF. *FF. »7E. *3C .CHECKER <1) 



1150 



BVTE *3C. *7E. *fl5. *fl5. *C3. »C3. «7E. *3C ; KING <2> 



BVTE »C3. «:66. *3C. *18. *18. *3C. t66. *C3 i CURSOR <2> 



1170 



BVTE 0. *FF. $FF. t-FF. *FF. *FF. *FF. ; BORDER C4; 
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< 



5628 



5628 
5629 
562R 
562B 
562C 
562E 
562F 
5620 

5631 
5632 
5633 
5634 
5635 
5636 
5637 
5638 
5629 
5630 
563B 
563C 
563D 
563E 
563F 

5640 
5641 
5642 
5643 



70 

70 

70 

46 

0054 

80 

06 

10 

07 
50 
07 
50 
07 
50 
07 
50 
07 
50 
07 
50 
07 
50 
07 

10 
06 
41 
2856 



5645 
5646 
5648 



564B 
564D 
5650 
5651 



48 

8956 

8D09D4 



0920 
3D00D4 
68 
40 



1160 
1190 

1200 

1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1230 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1680 



PRQE 



DISPLflV LIST 



DSP 



BVTE 
BVTE 
BVTE 
BVTE 
WORD 
BVTE 
BVTE 
BVTE 

BVTE 
BVTE 
BVTE 
BVTE 
BVTE 
BVTE 
BVTE 
BVTE 
BVTE 
BVTE 
BVTE 
BVTE 
BVTE 
BVTE 
BVTE 

BVTE 
BVTE 
BVTE 
WORD 



BLfiNKB ; 24 BLRNK LINES 

BLRNK8 

BLRNK8 

RELORD+6 ; LINES 0-7 MESSRQE LINE: 20 RCROSS X 5 COLOR X 1 LINE RESOLUTION CHRRRCTERS 

TITL 

INT+BLRNKl 



6 

BLRNK2 

7 

BLRNK6 

7 

BLRNK6 

7 

BLflNK6 

7 

BLRNK6 

7 

BLRNK6 

7 

BLfiNK6 

7 

BLRNK6 

7 

BLflNK2 
6 

JMPWT 
DSP 



8. 
9-16. 



INTERRUPT TO 
TOP BORDER; 



CHRNQE 
16 X 5 



CHRRRCTER BftSE ADDRESS RND CHRNGE TO NARROW SCREEN. 
X 1 CHRRS <LRST LINE IS TOP OF 1ST ROW OF SQURRES> 

17-18. TOP OF FIRST ROW OF SQURRES 

CHECKERBOARD <8 LINES OF CHARS WITH SPACES INBETWEEN - 22 LINES/SQUARE> 

19-34. 16X5X2 LINE RESOLUTION CHARS 

35-40. FIRST 3 LINES=BOTTOM OF PREVIOUS SQURRE. 

41-56 

57-62. LRST 3 LINES=TOP OF NEXT SQURRE. 

63-78 

79-84 

85-100 

101-106 

107-122 

123-128 

129-144 

145-150 

151-166 

167-172 

173-188 

NEXT THREE LINES ARE BOTTOM OF PREVIOUS SQURRE 
; 189-190. END OF NORMRL DISPLRV (SHOULD BE ON SCREEN ON ALL TV'S). 
; 191-198 BOTTOM BORDER <MRV OVERSCAN, BUT NOT ESSENTIAL TO GAME PLAV> 
;WRIT FOR NEXT VBLRNK/ THEN STRRT OVER 



DSP — DISPLRV LIST INTERRUPT HRNDLER. 

CHRNGES CHRRRCTER BRSE AND WIDTH OF DISPLAV FOR SPECIAL CHECKERS GRAPHICS 

THE OS WILL CHANGE CHBASE BRCK TO NORMRL DURING VERTICRL BLRNK. 

NCHR 

PHR 

LDR #GR/256 

STR CHBRSE 

; INSTRUCTION FETCH DMR ENRBLE, 
LDR «*2D 
STR DMRCTL 
PLR 
RTI 



P/M 2 LINE RES, P/M DMR ENRBLE, NRRROW SCREEN <128 CLOCKS) 
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5652 1690 PRQE 

1700 ; 

1710 . irJITIRLIZRTIOfJ CODE — SThPT EXECUTION HERE 

1720 ; 
5652 1730 ♦= PriE!+»700 

1740 ; 

1750 ; INIT OS'S DMRCTL VRRIRBLE 

1760 ; INSTRUCTION FETCH DMR ENRBLE. P/M 2 LINE RES. P/M DMR ENRBLE. STRNDRRD SCREEN <160 CLOCKS > 

1770 > 
5700 fl92E 1780 LDR «»2E 
5702 8D2F02 1790 STR SDMCTL 

1800 ; 

1810 ; CLEAR RRM 

1820 ; 
5705 fl900 1830 LDR #0 

5707 Rfl 1840 TRX 

1850 INITLP 

5708 9D0050 1860 STR PMB. X 
5708 9D0051 1870 STR PMB+*100, X 
570E 9D0052 1880 STR PMB+*200, X 
5711 9D0053 1890 STR PMB+*300, X 
5714 9D0054 1900 STR PMB+*400. X 

5717 E8 1910 I NX 

5718 D0EE 1920 BNE INITLP 

1930 ; 

1940 ; INITIRLIZE MISSILE GRRPHICS FOR BORDERS 

1950 ; 
571fl R90E I960 
571C R05E 1970 
571E 999451 1980 LQP2 
57^1 88 1990 



^ 5722 D0FR 2000 

. 2010 



LDR 


««0E 


LDV 


«*5E 


STR 
rstrv 


GRri03+«14. V 


ffcY 

BNE 


LQPZ 



2020 ; INITIRLIZE TOP RND BOTTOM BORDERS. 

2030 ; 

5724 R010 2040 LDV #16 

5726 R9C4 2050 LDR #CLBOR+BORDER 

5728 991354 2060 TBLP STR TOPBRD-1, V 

572B 99fl354 2070 STR BOTBRD-1, V 

572E 88 2080 DEV 

572F D0F7 2090 BNE TBLP ; CONTINUE UNTIL V=0 

2100 ; 

2110 i INITIRLIZE PLRVER GRRPHICS FOR SQURRES <CHECKER BOflRD> V-0 

2120 ; 

5731 R9F0 2130 LDR »*F0 

5733 fl20fl 2140 IN2 LDX #10 

5735 991852 2150 1N3 STR GRP0+*18. V 

5738 999852 2160 STR GRP1+*18, V 

573B 991853 2170 STR GRP2+*18> V 

573E 999853 2180 STR GRP3+»18, V 

2190 ; 
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5741 
5742 
5744 
5747 
5748 
5749 
574fi 
574C 
574E 
5750 
5752 



48 

fl90fl 

999851 

68 

C8 

ca 

10E9 
49FF 
C058 
90E1 
0008 



^ 5754 
r 5757 


B9D857 


9900D0 


VX5 5750 


8R 


575B 


9908D0 


575E 


B9E057 


5761 


99C002 


5764 


88 


5765 


i0ED 



5767 
5769 
576C 
576E 
5771 
5773 
5776 
5778 
577B 
577D 
5780 
5782 
5785 
5737 
578R 



fl928 

8D3002 

R956 

8D3102 

0903 

8D1DD0 

0950 

8D07D4 

0914 

8D6F02 

0945 

800002 

0956 

8D0102 

8E0ED4 



5780 O20B 



':755F 
57yl 
5734 
5796 
5799 
5790 



0901 

900050 

0981 

901450 

Cfl 

10F3 



2200 
2210 
2220 
2230 
2240 
2250 
2260 
2270 
2280 
2290 
2300 
2310 
2320 
2330 
2340 
2350 
2360 
2370 
2380 
2390 
2400 
2410 
2420 
2430 
2440 
2450 
2460 
2470 
2480 
2490 
2500 
2510 
2520 
2530 
2540 
2550 
2560 
2570 
2580 
2590 
2600 
2610 
2620 
2630 
2640 
2650 
2660 
2670 
2680 
2690 
2700 
2710 



PHO 

LOO #*0R 

STO GRM03 + *13. V ; REST OF MISSILE QROPHICS 

PLO 

INV 

OEX 

BPL IN3 

EOR »*FF ; FILL IN OPPOSITE SQUORES 

CPV #38 

BCC IN2 

LOV #8 

; INITI0LI2E PLOVER OND MISSILE POSITIONS OND COLORS 



*FF 

*03 I NO I COTES 4 TIMES NORMOL SIZE <REST IS OON'T CORE> 



IN4 LOR ITBL. V 

STO HPOSP0, V 

TXfl 

STO SIZEP0. V 

LOO ITBLl. V 

STR PCOLR0. V 

OEV 

BPL IN4 



OS, RNTIC, POKEV INITIOLIZOTION 

LOO #OSP&*FF i OISPLOV LIST STRRT RDORESS <LSB> 

STO SDLSTL 

LOO #DSP/256 ; MSB OF OODRESS 

STR SDLSTH 

LOO #3 

STR GRRCTL 

LOR »PMB/256 

STR PMBRSE 

LOR »*14 

STO GPRIOR 

LOR »NCHR&*FF 

STR VOSLST 

LOO »NCHR/256 

STR VDSLST+1 

STX NMIEN 



ENOBLE PLOVER/MISSILE OMO TO QROPHICS REGS. 

MSB OF ODORESS OF PLOVER/MISSILE QROPHICS 

5TH PLOVER ENOBLE <USE PF3 FOR MISSILE COLOR), PF TRKES PR 10 OVER PLflVERS 

OS PR I OR I TV REG 

OISPLRV LIST INTERRUPT VECTOR <LSB> 



; X=»FF 

; INI TIL I ZE BOORO OISPLOV 
LOX #11 



*C0 ENABLES OISPLOV LIST & VBLONK INTERRUPTS. 



BROLP 



LDR ttCHECKEP+CLPe , HUNON PIECES Or4 SOUhPES 0-11 

Sro BOHPD, X 

LOO #CHECKER+CLP1 , COMPUTER PIECES ON SQURRES 20-31 

STR BOflRO+20, X 

OEX 

BPL BROLP 
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< 

1—' 
O 







2720 






2730 


5?5C 


R213 


2740 


579E 


BDE957 


2750 


5701 


9D0054 


2760 


57ft4 


Cfl 


2770 


57fl5 


10F7 


2780 
2790 
2800 
2810 
2820 
2830 


57fl7 


20flD57 


2840 


57flR 


4Cfi757 


2850 
2860 
2870 
2880 
2890 
2900 
2910 
2920 


57fiD 


fl21F 


2930 


57flF 


fl000 


2940 
2950 


57B1 


0903 


2960 


57B2 


8D2050 


2970 
2980 


57B6 


BD0050 


2990 


57B9 


992654 


3000 


57BC 


BDFC4F 


3010 


57BF 


993454 


3020 


57C2 


C8 


3030 


57C2 


C8 


3040 


57C4 


C8 


3050 


57C5 


C8 


3060 


57C6 


CR 


3070 


57C7 


CE2Q50 


3080 


57Cfl 


IGEfl 


2090 

3100 


57CC 


98 


3110 


57CD 


18 


3120 


57CE 


6910 


3130 


57D0 


R8 


3140 


57D1 


8R 


3150 


57D2 


E902 


3160 


57D4 


RR 


3170 


57D5 


B0DR 


3180 


57D7 


60 


3190 
2200 
3210 
3220 
3230 



;f10VE COPVRIGHT riES3RQE TO MESSRGE DISPLAY LINE 

LVy. *19 

IN6 LDH COPY, X 

STR 7ITL, X 
DEX 

BPL IN6 

LOOP TO MOVE BOARD TO GRAPHICS ARER. 

THE CHECKERS PROGPRM LOGIC COULD BE ADDED HERE OR A VBLANK INTERRUPT COULD BE USED. 



LOOP 



JSR 
JMP 



UPCHR 
LOOP 



UPCHR — SUBROUTINE TO MOVE 22 BYTES OF CHECKER BOARD TO DISPLAY RAM. 
UPCHR 



UPLPl 



UPLP2 



LDX 
LDY 

LDR 
STR 

LDR 
STR 
LDR 
STR 
I NY 
I NY 
I NY 
I NY 
DEX 
DEC 
BPL 

TYR 
CLC 
RDC 
TRY 
TXR 
SBG 
TRX 
BCS 
RTS 



#31 
#0 



#4-1 
T0 



; SQURRE 31 = UPPER LEFT 



; 4 SQUARES/LINE 



BOARD. X 

BRDSP+2. V ; FOR ROWS SHIFTED TO RIGHT 

BORRD-4. X 

BRDSP+«10>Y ; FOR ROWS SHIFTED TO LEFT 



T0 
UPLP2 



#*10 

#4-1 
UPLPl 



CARRY IS CLEAR < SUBTRACT 4> 
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57D8 3C 
57D9 5C 
57Dfl 7C 
57DB 9C 
57DC BC 
57DD 28 
57DE 38 
57DF 38 



57E0 24 
57E1 34 
57E2 24 
57E2 34 
57E4 26 
57E5 88 
57E6 0E 
57E7 26 
57E8 00 



0000 
0030 
0040 

57E9 00 
57Efl 22 
57EB 2F 
57EC 30 
57ED 39 
57EE 22 
57EF 29 
57F0 27 
57F1 28 
57F2 34 
57F2 fll 
57F4 B4 
57F5 Rl 
S7F6 B2 
57F7 R9 
57F8 51 
57F9 59 
57Ffl 58 
57FB 50 



3240 ; DRTR 

3250 J HORIZONTAL POSITIOrj OF PLflVERS CSQURRES) AND MISSILES <SIDE BORDERS >. 

3260 ^tie^PlGHT BORDER- M1=LEFT BORDER 

3270 ;M2 & M3 RKE FLRCED WITH Ml. 

3280 ; P0- PI- P2/ P3, M0, Ml. M2, M2 

3290 ITBL 

2200 . BVTE *3C- *5C. »7C. »9C, *BC. »38. t38. *38 



2210 ; 

2220 ; COLOR TABLE 

2220 ITBLl 

3340 . BVTE *34> *34, «34, »34 i A PLRVERS (RED SQUARES) 



BVTE *36 
BVTE S88 
BVTE *0E 
BVTE *26 
BVTE 



;PF0 
jPFl 
;PF2 
;PF3 
iBK: 



2350 

2260 

2370 

3380 

3390 

2400 ; 

2410 ; "COPVRIGHT ATARI 1980" MESSAGE 

3420 i 

3430 OF 

3440 0F2 

3450 0F3 

3460 TGTBL 

3470 COPV 



RED CHECKERS AND MESSAGES 
BLUE CHARACTERS 
WHITE CHECKERS AND MESSAGES 
VELLOW BORDER < CHARS & MISSILES) 
BLACK BACKGROUND 



*00 
t80 
»40 



FOR PF0 COLOR CRED> 
FOR PF2 COLOR < WHITE) 
FOR PFl COLOR <BLUE) 



BVTE SPI> Cl+OF, OI+OF, PI+OF, VI+OF. RI+OF, II+OF, GI+OF. HI+OF. TI+OF 



3480 



BVTE AI+0F2.. T1+0F2. A1+0F2, RI+0F2, II+0F2, N1I+0F3. N9I+0F2. N8I+0F3. N0I+OF3 



V. HARDWARE REGISTER LISTS 



A. 



ADDRESS ORDER 



CTIA ADDRESSES 







WRITE 


READ 


Address 


Name 


Description 


Name 


Description 


DO 

i 

DO 


FF 
20 


> REPEAT AS BELOW 
J 


7 MORE TIMES 


DOIF 


CONSOL 


Write Consol SW.Port 


CONSOL 


Read Consol SW. Port 


DOIE 


HITCLR 


Collision Clear 






DOID 


GRACTL 


Graphic Control 






DOIC 


VDELAY 


Vert. Delay 






D91B 


PRIOR 


Priority Select 






DOIA 


COLBK 


Col-lum Bkgnd 






D019 


C0LPF3 


Color-lum of 3 






D018 


C0LPF2 


Playfield 2 






D017 


COLPFl 


Playfield 1 






D016 


COLPFO 


Playfield 






D015 


C0LPM3 


Color-lum of 3 






D014 


C0LPM2 


Player-Missile 2 


PAL 


READ PAL/NTSC bits 


D013 


COLPMl 


Player-Missile 1 


TRIG3 


Read Joystick 


D012 


COLPMO 


Player-Missile 


TRIG2 


Trigger 


DOU 


GRAFM 


Graphics All Missiles 


TRIGl 


Buttons 


DOlO 


GRAFP3 


Graphics Player 3 


TRIGO 




DOOF 


GRAFP2 


Graphics Player 2 


P3PL 


Read Player 


DOOE 


GRAFPl 


Graphics Player 1 


P2PL 


to Player 


DOOD 


GRAFPO 


Graphics Player 


PIPL 


Collisions 


DOOC 


SIZEM 


Size All Missiles 


POPL 




DOOB 


SIZEP3 


Size Player 3 


M3PL 


Read Missile 


DOOA 


SIZEP2 


Size Player 2 


M2PL 


To Player 


D009 


SIZEPl 


Size Player 1 


MIPL 


Collisions 


D008 


SIZEPO 


Size Player 


MOPL 




D007 


HP0SM3 


Horz. Posit. Missile 3 


P3PF 


Read Player 


D006 


HP0SM2 


Horz. Posit. Missile 2 


P2PF 


To Playfield 


D005 


HPOSMl 


Horz. Posit. Missile 1 


PIPF 


Collisions 


D004 


HPOSMO 


Horz. Posit. Missile 


POPF 




D003 


HP0SP3 


Horz. Posit. Player 3 


M3PF 


Read Missile 


D002 


HP0SP2 


Horz. Posit. Player 2 


M2PF 


To Playfield 


DOOl 


HPOSPl 


Horz. Posit. Player 1 


MIPF 


Collisions 


DOOO 


HPOSPO 


Horz. Posit. Player 


MOPF 





V.l 



ANTIC ADDRESSES 







WRITE 


READ 


Address 


Name 


Description 


Name 


1 Description 


D4] 
D4 


FF 
10 


> REPEAT (AS BELOW) 


15 


MORE TIMES 


D40F 


NMIRES 


Reset NMI 
Interrupt Status 
NMI Interrupt- 


NMIST 


NMI Interrupt 
Status Register 


D40E 


NMIEN 


ENABLE 






D40D 






PENV 


Light Pen Register 
Vertical 


D40C 






PENH 


Light Pen Register 
Horizontal 


D40B 






VCOUNT 


Vertical Line 
Counter 


D40A 


WSYNC 


Wait for HBLANK 
Synchronism 






D409 


CHBASE 


Character Base 
Address Red 






D408 










D407 


FMBASE 


Player-Missile Base 
Address Register 






D406 










D405 


VSCROL 


Vertical Scroll 
Register 






D404 


HSCROL 


Horizontal Scroll 
Register 






D403 


DLISTH 


Display List 
Pointer (High Byte) 






D402 


DLISTL 


Display List 
Pointer (Low Byte) 






D401 


CHACTL 


Character Control 
Register 






D400 


DMACTL 


DMA Control 
Register 







V.2 



POKEY ADDRESSES 





WRITE 


READ 




Name 


1 Description 


Name 


Description 


D2FF 
D210 


> REPEAT (AS BELOW) 


15 MORE TIMES 


D20F 


SKCTLS 


Serial Port 4 Key 
Control 


SKSTAT 


Serial Port 4 Key 
Status Register 


D20E 


IRQEN 


IRQ Interrupt 
Enable 


IROST 


IRQ Interrupt 
Status Register 


D20D 


SEROUT 


Serial Port 
Output Reg. 




Serial Port 
Input Register 


D20C 










D20B 


POTGO 


Start Pot Scan 
Sequence 




Vertical Line 


D20A 


SKRES 


Reset Status 
(SKSTAT) 


RANDOM 


Random Numb 
Generator 


D209 


STIMER 


Start Timers 


KBCODE 


Keyboard Code 


D208 


AUDCTL 


Audio Control 


ALLPOT 


Read 8 Line Pot 
Port State 


D207 


AUDC4 


Audio Channel 4 
Control 


POT 7 




D206 


AUDF4 


Audio Channel 4 
Frequency 


POT 6 




D205 


AUDC3 


Audio Channel 4 
Control 


POT 5 


Read the 


D204 


AUDF3 


Audio Channel 3 
Frequency 


POT 4 


value of 
each POT 


D203 


AUDC2 


Audio Channel 2 
Control 


POT 3 




D202 


AUDF2 


Audio Channel 2 
Frequency 


POT 2 




D201 


AUDCl 


Audio Channel 1 
Control 


POT 1 




D200 


AUDFl 


Audio Channel 1 
Frequency 


POT 





V.3 



PIA ADDRESSES 





WRITE 


READ 


Address 


Name 


Description 


Name 


Description 


D3FF 
D304 


Repeat i 


IS shown below many times 


5 




D303 


PBCTL 


PORT B CONTROL 


PBCTL 


Same as write 


D302 


PACTL 


PORT A CONTROL 


PACTL 


Same as write 


D301 


PORTB 


Direction Register 
If PBCTL Bit 2-0 
(otherwise) 


PORTB 


Same as write 




PORTB 


Jack 2 & Jack 3 
If Direction Bits 
Are I * 


PORTB 


Jack 2 6e Jack 3 
If Direction Bits 
Are * 


D300 


PORTA 


Direction Register 
If PACTL Bit 2=0 
(Otherwise) 


PORTA 


Same as write 




PORTA 


Jack & Jack 1 
If Direction Bits 
Are 1 * 


PORTA 


Jack & Jack 1 
If Direction Bits 
Are * 



* NOTE: Output data is retained in Jack Output Registers. 
If direction bits are true, a read of the jacks 
will read old data from these registers. 



B. ALPHABETICAL ORDER 



Hardware Register 


OS Shadow 




Address 


Address 




Name 


Description 


Hex 


Dec 


Name 


Hex 


Dec 




ALLPOT 


Read 8 line Pot Port State 


D208 


53768 










AUDCl 


Audio Channel 1 Control 


D201 


53761 










AUDC2 


Audio Channel 2 Control 


D203 


53763 










AUDC3 


Audio Channel 3 Control 


D205 


53765 










AUDC4 


Audio Channel 4 Control 


D207 


53767 










AUDCTL 


Audio Control 


D208 


53768 










AUDFl 


Audio Channel L Frequency 


D200 


53760 










AUDF2 


Audio Channel 2 Frequency 


D202 


53762 










AUDF3 


Audio Channel 3 Frequency 


D204 


53764 










AUDF4 


Audio Channel 4 Frequency 


D206 


53766 










CHACTL 


Character Control 


D401 


54273 


CHART 


2F3 


755 




CHBASE 


Character base address 


D409 


54281 


CHBAS 


2F4 


756 




COLBK 


Color-Luminance of Background 


DOIA 


53274 


C0L0R4 


2C8 


712 




COLPFO 


Color Luminance of Playfield 


D016 


53270 


COLORO 


2C4 


708 




COLPFl 


Color Luminance of Playfield 1 


D017 


53271 


COLOR 1 


2C5 


709 




C0LPF2 


Color Luminance of Playfield 2 


D018 


53272 


C0L0R2 


2C6 


710 




C0LPF3 


Color Luminance of Playfield 3 


DO 19. 


53273 


C0L0R3 


2C7 


711 




COLPMO 


Color Luminance of Player-Missile 


D012 


53266 


PCOLRO 


2C0 


704 




COLPMl 


Color Luminance of Player-Missile 1 


D013 


53267 


PCOLRl 


2C1 


705 




C0LPM2 


Color Luminance of Player-Missile 2 


D014 


53268 


PC0LR2 


2C2 


706 




C0LPM3 


Color Luminance of Player-Missile 3 


D015 


53269 


PC0LR3 


2C3 


707 




CONSOL 


Console Switch Port 


DOIF 


53279 


Set to 8 during VBLANK 




DLISTH 


Display List Pointer (high byte) 


D403 


54275 


SDLSTH 


231 


561 




DLISTL 


Display List Pointer (low byte) 


D402 


54274 


SDLSTL 


230 


560 




DMACTL 


Direct Memory Access (DMA) Control 


D400 


54272 


SDMCTL 


22F 


559 




GRACTL 


Graphic Control 


DOID 


53277 










GRAFM 


Graphics for all Missiles 


DOU 


53265 










GRAFPO 


Graphics for Player 


DOOD 


53261 










GRAFPl 


Graphics for Player 1 


DOGE 


53262 










GRAFP2 


Graphics for Player 2 


DOOF 


53263 










GRAFP3 


Graphics for Player 3 


DOlO 


53264 










HITCLR 


Colission Clear 


DOIE 


53278 










HPOSMO 


Horizontal Position of Missile 


D004 


53252 










HPOSMl 


Horizontal Position of Missile 1 


D005 


53253 










HP0SM2 


Horizontal Position of Missile 2 


D006 


53254 










HP0SM3 


Horizontal Position of Missile 3 


D007 


53255 










HPOSPO 


Horizontal Position of Player 


DOOO 


53248 










HPOSPl 


Horizontal Position of Player 1 


DOOl 


53249 










HP0SP2 


Horizontal Position of Player 2 


D002 


53250 










HP0SP3 


Horizontal Position of Player 3 


D003 


53251 










HSCROL 


Horizontal Scroll 


D404 


54276 










IRQEN 


Interrupt Request (IRQ) Enable 


D20E 


53774 


POKMSK 


10 


16 




IRQST 


IRQ Status 


D20E 


53774 










KBCODE 


Keyboard Code 


D209 


53769 


CH 


2FC 


764 




MOPF 


Missile to Playfield Collisions 


DOOO 


53248 










MOPL 


Missile to Player Collisions 


D008 


53256 










MIPF 


Missile 1 to Playfield Collisions 


DOOl 


53249 










MIPL 


Missile 1 to Player Collisions 


D009 


53257 










M2PF 


Missile 2 to Playfield Collisions 


D002 


53250 










M2PL 


Missile 2 to Player Collisions 


DOOA 


53258 









V.5 



Hardware Register 


OS Shadow 




Address 




Address 


Name 


Description 


Hex 


Dec 


Name 


Hex 


Dec 


M3PF 


Missile 3 to Playfield Collisions 


D003 


53251 








M3PL 


Missile 3 to Player 


DOOB 


53259 








NMIEN 


Non-Maskable Interrupt (NMI) Enable 


D40E 


54286 


Set to $40 by IRQ code 


NMIRES 


NMI reset 


D40F 


54287 


written 1 


to by NMI code 


NMIST 


NMI Status 


D40F 


54287 


read by NMI code 




POPF 


Player to Playfield Collisions 


D004 


53252 








POPL 


Player to Player Collisions 


DOOC 


5326G 








PIPF 


Player 1 to Playfield Collisions 


D005 


53253 








PIPL 


Player 1 to Player Collisions 


DOOD 


53261 








P2PF 


Player 2 to Playfield Collisions 


D006 


53254 








P2PL 


Player 2 to Player Collisions 


DOGE 


53262 








P3PF 


Player 3 to Playfield Collisions 


DGG7 


53255 








P3PL 


Player 3 to Player Collisions 


DGGF 


53263 








PACTL 


Port A Control 


D3G2 


54G18 


Set to $3C by IRQ Code 


PAL 


PAL/NTSC indictor 


DG14 


53268 




1 


1 


PBCTL 


Port B Control 


D3G3 


54G19 


Set to $3C by IRQ Code 


PENH 


Light Pen Horizontal Position 


D4GC 


54284 


LPENH 


234 


564 


PENV 


Light Pen Vertical Position 


D4GD 


54285 


LPENV 


235 


565 


PMBASE 


Player Missile Base Address 


D4G7 


54279 








PORTA 


Port A 


D3GG 


54G16 


STICKOa 


278,279 


632,633 


PORTB 


Port A 


D3G1 


54G17 


STICK2,3 


27A,27B 


634,635 


POTO 


Pot 


D2GG 


53760 


PADDLO 


270, 


624 


POTl 


Pot 1 


D2G1 


53761 


PADDLl 


271 


625 


P0T2 


Pot 2 


D2G2 


53762 


PADDL2 


272 


626 


P0T3 


Pot 3 


D2G3 


53763 


PADDL3 


273 


627 


P0T4 


Pot 4 


D204 


53764 


PADDL4 


274 


628 


POTS 


Pot 5 


D2G5 


53765 


PADDL5 


275 


629 


P0T6 


Pot 6 


D206 


53766 


PADDL6 


276 


630 


POT 7 


Pot 7 (right paddle controller) 


D2G7 


53767 


PADDL7 


277 


631 


POTGO 


Start POT Scan Sequence 


D2GB 


53771 


WRITTEN DURING VBLANK 


PRIOR 


Priority Select 


DGIB 


53275 


GPRIOR 


26F 


623 


RANDOM 


Random number generator 


D2GA 


53770 








SERIN 


Serial Port Input 


D2GE 


53774 








SEROUT 


Serial Port output 


D20D 


53773 








SIZEM 


Sizes for all missiles 


DGGC 


5326G 








SIZEPO 


Size of Player 


DGG8 


53256 








SIZEPl 


Size of Player 1 


DG09 


53257 








SIZEP2 


Size of Player 2 


DGOA 


53258 








SIZEP3 


Size of Player 3 


DGOB 


53259 








SKCTL 


Serial Port Control 


D20F 


53775 


S SKCTL 


232 


562 


SKREST 


Reset Serial Port Status (SKSTAT) 


D2GA 


5377G 








SKSTAT 


Serial Port Status 


D2GF 


53775 








S TIMER 


Start Timer 


D2G9 


53769 








TRIGG 


Joystick Controller Trigger 


DGIO 


53264 


STRIGG 


284 


644 


TRIGl 


Joystick Controller Trigger 1 


DGll 


53265 


STRIGL 


285 


645 


TRIG2 


Joystick Controller Trigger 2 


DG12 


53266 


STRIG2 


286 


646 


TRIG3T 


Joystick Controller Trigger 3 


DG13 


53267 


STRIG3 


287 


647 


VCOUNT 


Vertical Line Counter 


D4GB 


54283 








VDELAY 


Verical Delay 


DGIC 


54276 








VSCROL 


Vertical Scroll 


D4G5 


54277 








WSYNC 


Wait for Horizontal Sync 


D4GA 


54282 


Used by 1* 
click rou 


:eyboard 
I tine 





V.6 



VI . FIGURES 



A. MEMORY MAP 
ADDRESS 



FUNCTION 



SIZE 



FFFF 
D800 


Operating System 

And 
Math Routines 


lOK 


D000-D7FF 
CFFF 


Hardware Addresses 

Reserved for Future 
O.S. expansion 


2K 
4K 


BFFF 
8000 


ROM Cartridge 

(Colleen left and right 
slot and Candy single 
slot all address to 
this space) 


16K 


7FFF 
2000 


RAM 
Expansion * 




IFFF 


RAM initially 
supplied in the 
product 


8K 



RAM expansion can actually exten to BFFF. However, the ROM cartridges 
will deselect the RAM. Deselection occurs on 8K boundaries. Atari 400 
units are RAM expandable only at the factory. They can accept RAM up 
to 2FFF (16K) when fully extended. 



VI. 1 



277 '58 , ^ 

274 I 137 1 SET VSYNCX 
RESET VSYNC 



* 



127 



128 



247 
246 



274 



^ 3 



fc3 



G4 



125 



124- 



137 



275 



137 



RESET -\ 
VCTR ^ 

RESET_^ 
VBLANK 
r START 
DISPLAY) 



CENTER 
SCREEN 

lU 

z 

_l 

CM 

h- 
Z 
3 
O 
«^) 
> 

SET 

VBLANK 

SET — 
VSVNC 






PAL VERTICAL 
" DISPLAY - 







7^< <j^ 



IL 



az 

turn 
za 



il 






z 



s 



Q 

2 



3 



NARROW F>LyKVFlELD 
123 COLOR CLOCKS 



Q 
Z 

i 



STANDARD PL^VFIELD 
l(SO COLOR CLOCKS 



-C^ 



\r/IDE PLAVFIELD 
I7G COLOR CLOCKS DiSPLAVED 
(132 COLOR CLOCKS READ) 



■SET VSYNC 
RESET VSYNC 
RESET VCTR 

I 255 

at. 250 1 125, 



125 



2S4 

261 



-•^RESET 
VBUVNK 
(START 
DISPLAY) 



CENTER 

-(-OF 

SCREEN 



^% 



HORIZONTAL P^DSlTlON REGISTER VALUES 



NT5C AND PAL HORIZONTAL DISPLAY 



i 

m 



>'-seT 

VBLANK 



V 



^ 



I^ 



28 



250 



247 , 



I2<s 



-127 
130 



61 



SET 



248 



251 



z 
o 

D 
J 

o 
t/) 

UJ 

a 

UJ 

Z 
_j 
OJ 

I 

\- 

z 

D 

o 
o 

> 



125 



124- 



125 



VSYNC 



§ 



NTSC 
VERTICAL 
DISPLAY- 



MASTER 
CLOCK 



o 
a: 

o 

3 O 
O. V> 



^ 






O H 
bj 

2^ 



POWER 

ON 
RESET 



PERSONALITY 
ROMS 



MEMORY 
DECODER 



^t 



< 

"1 bj 

Ul o 

2 O 

< v> 



ADDRESS BUS 



DATA BUS 



> 



^ 



TRIGGER LINES 



P 


K 

E 
Y 



KEYBOARD 



^ 



LUMINENCE a COLOR 



VIDEO 
SUMMING 



I 



— ^— - 



AUDIO 
MOO 



-^ 



Yii 



>^ 






J 107 



PADOLE 
CONTROL- 
LER 



1 



JOYSTICK 
CONTROL- 
LER 



KEYBOARD 
SPEAKER 



MOTHER BOARD 
ATARI 400 



PAGE I 



400 MOTHER BOARD 




TEST 
POINTS 



400 MOTHER BOARD 



PAGE 2 



0^58 




MASTER 
CLOCK 



3 t> 



AY 






± 



111 

«t 

O ol 

CD V) 



-X 



O UJ 

< o 

o o 

m to 



-X 



o m 

a: M 

< o 

o o 

m to 



- <^ 



lU 




1- 




< 


IC 


1- 


UJ 


w 


u. 


I 


k. 






ir 


3 


H 


O 



XJ- 



^4- 




MEMORY 
DECODER 



4r 



ADDRESS BUS 



^¥ 



DATA BUS 



<> 



iX 



^ 



TRIGGER LINES 



^ 



P 


K 

E 
Y 



LUMINENCE 



COLOR 



1 



VIDEO 
SUMMING 



POWER 

ON 
RESET 



AUDIO 
MOO 



> 



^ 



J 114 



> 



— > 



fj 



P 
I 

A 



-^ 



J 115 



KEYBOARD 



1 



KEYBOARD 
SPEAKER 



PADDLE 
CONT- 
ROLLER 



JOYSTICK 
CONTROL- 
LER 



MOTHER BOARD 
ATARI 800 



800 MOTHER BOARD 



PAGE I 




800 MOTHER BOARD 

PAGE 2 







TO CONTROL SWITCHES 



(FROM 
POWER 

ADAPTER) 



J 

2 




^ 



£ 



VOLTAGE 
BOOST 



I 



RIPPLE 
FILTER 



I 



12 VOLT 

REGUL- 
ATOR 



Y 



INTERLOCK 
SWITCH 



POWER 
SWITCH 



1 



-<4> 



BRIDGE 
RECTI- 
Fl ER 



I 



RIPPLE 
FILTER 



POWER SUPPLY BOARD 
ATARI 400 



1 



VOLTAGE 
BOOST 



I 



RIPPLE 
FILTER 



(TO MOTHER BOARD) 




400 POWER SUPPLY 



CR2I0 



XcR20 



^ 



^ SIS 



L205 



7eMI2 
A20I 



6 

1 



^ 



C203 
.22 



ItZOI 



X3 icH5 1, 1 



CAOI2I74 
A 203 



R203 
'6.SK 



S3f 



i^g^V 



;c2io 

,22/iF 



GND 

+ 5A/BEA0Y 

+12 

INTERRUPT 

AUDIO IN-«— 



PROCEED 
COMMAND 

DATA OUT *■ 

DATA IN -• 

ClOCK IN >« 

CLOCK OUT —*- 
MOTOR CONTMM. 



9 



R203 
33, 2 W 



7S05 
A202 



T 




INTERLOCK 
SWITCH 



HD 



J-C2II 
"" .22 



r!:>- 1204 f-=i 

«02 4:C2I3 >?? 
;j.ooi 



(FROM 
POWER 

ADAPTER) 



J 
2 




f 



VOLTAGE 
BOOST 



I 



RIPPLE 
FILTER 



I 



12 VOLT 
REGUL- 
ATOR 



I 



CONTROL 
SWITCHES 



J 202 



INTERLOCK 
SWITCH 



POWER 
SWITCH 



-4AI^ 



+ 5A 



YV ^'V 



I 



J 201 



(TO MOTHER BOARD) 



BRIDGE 
RECTI- 
FIER 



I 



RIPPLE 
FILTER 



5 VOLT 

REGUL- 
ATOR 



L C 
FILTER 



-f SB 






->- 



I 



R F 
MOD 



POWER SUPPLY BOARD 
ATARI 800 



TO PERIPHERAL JACK 



TO TELEVISON 



COMPOSITE VIDEO (TO MONITOR JACK) 

£7 _3. 



J 205 



1 



1 



VOLTAGE 
BOOST 



I 



RIPPLE 
FILTER 



I 



POWER 

ON 
LITE 



I 



-5 VOLT 
REGUL- 
ATOR 



J 

2 

J3. 



J 204 




BESET 



OPTION 
SELECT 



GAME 
SELECT 



GAME 
START 



d 



800 POWER SUPPLY 



L202 



C2I4 



ir 



CAOI2I74 
A 203 



1 1 

I CHAN 

|S203 C209+ C2" 

i6cH3 J.^ 'a.io 



%R204 
► 9.1 K 



L205 

-a- 



^ 



^ 



C2II 
10 



4224 



1 520 4 
Z±3 



|S20 8 



IS206 



I 



-ISZ^ T 



^C2I6 

5~' 



^ 



GNO 

4 S B/READV 
4^12 

INTERRUPT 
CtOCK GOT — p' 
PROCEED 
COMMAND 

DATA OUT ^ 

DATA IN -* 

CLOCK IN ■< 

MOTOR CONTROL 
AUDIO IN -* 



COMP CHROMA 
AUDIO OUT — ► 
COMP VIDEO 
COMP UIM 
GNO 



NOTE: 

I. UNLESS OTHERWISE SPECIFIED 

(A) ALL CAPACITORS ARE IN/iF 

(B) AU RESISTORS ARE IN OHMS, I/4W, S% 



4203 





^. 






ADDRESS 


BUS 


















w 


V 




\ 




^' 




1 


o 
















cc 


















< 


















o 




ROM 




ROM 




ROM 




ADDRESS 


CD 
















MULTIPLEXER 


CC 


















111 


















X 


















h- 


^ 
















o 


5 


DAI 


FA BUS 


\f 




t 




1 


|r ^ 


f 


o 




DATA BUFFER SELECT 








^ 

^ — 


CHIP SELECTS 









PERSONALITY BOARD 
ATARI 80 



< 



REFRESH 



ADDRESS BUS 



o 

< 
o 

CD 

OC 
UJ 

X 
I- 
O 



o 



iVlDEO 



SIGNALS 



-^ 



RI06ER 



INES 
CONTROL 



SWITCHE » 



-^►- 



02 CLOCK 



00 ( 



LOCK 



01 CLOCK 




CLOCK 
OENERATO 



00 CLOCK 



CPU BOARD 



CPU BOARD 






^fc^ DATA LINES 








DATA OUT 






TRI- 






\ 


STATE 
BUFFER 




■^^' 






\ 


DATA IN 




Q 












+ 1 


or 
< 


■w 


SECTION 
ENABLE 




ADDRESS 
DEMULTIPLEXER 


•^ ADDRESS LINES ^ 


8 RAM CHIPS 


o 


^ 


w 


or 

UJ 


^ AODRE 


SS LINES 


\r W 


X 

o 


■^ - 


\ — ►- 








i 


^ 




^ 


DELAY 
CIRCUIT 




ii 


^ 




b- CAS 




o 


»^ REFRESH 








^ 


P^ 




H 


w- ■ 




k 








^ 


r 














^ 


BOARD 
SELECT 


1 


DELAY 
CIRCUIT 








W 














^ 


















As 















8K DYNAMIC RAM 

ATARI 



< 

CD 



«o« 1 



ma 
xneo 



TJLX 



!2 55s a- 5:12s 



g° t.o 



NM 

inoa 



IS 9 S S 9 



r .13 § 



2 = B -r = a - 



50f ^ — ^ 



•T"T 



a* 

MS 



li 55S 3 3 ::la!s 



B t -i 






.^ 



T ^Tt 



1^ 



mS 



lo^r^"* "" "^ 



=0 



hh: 






M»risisp 



35* 



ia 5 s jassj JUL 



-Ot— — 



iov 

TO-J— r«V 



MIO 



3 • • 



OS 

S8 



3 3 



^ ' ' ^MaU l til- I Mds 



2VT-Z 



NIO 

3a» 



Si 



!2;5:5S3:I3|| 



rL 



CIS»I03 * 



:<H 



' -T 



^t^lSUIgfl-lslgfl 






So 



I2 55::3;:l2ls 



xn 




T7T 



£ ti 6 ;r j|il_; : 

8 •tltlM tosz 
• »t»t09 



e_± 



S8 S 

83 S 



^S tiiaivx. *ecz 



a 



u 

X 

u 

IA 

K 

3 
9 
-» 


M 
K 
W 

B. 
3 

? 



bi 

Z 
Z 

8 







a 


bi 
u 


lb 


i 

u. 

3 


m 
m 
o> 

M 

3 
3 


< 
s 
a> 

N 

■n 

3 
3 





3 




3 


i 

(E 

e. 

K 


<0 
10 
10 


u 


Ml 
IS 
K) 

<r 


u 


10 

J 


u 


10 

IS 

10 

; 


u 






2? 
HI; 

'o-tHH 



- 3 

g 
3 



• M : V O 



»«««««« 



o 
a: 
< 
o 

q: 

X 

o 



o 



DATA OUT 



DATA BUS 



DATA IN 



TR I- 

STATE 

BUFFER 



ADDRESS BUS 



ADDRESS BUS 



QC 
lU 
X 
UJ 

_J 

o. 

UJ >J 
a: => 
o 2 

Q bJ 
< Q 



T 



REFRESH 



1 



BOARD 
SELECT 



T 



1^ ADORE S^ES 



DELAY 
CIRCUT 



di 



8 RAM CHIPS 



CAJL 



DELAY 
CI RCUT 



RAS 



16 K DYNAMIC RAM 

ATA R I 



I6K RAM 



M/VtMur 



R/W UtTI 




Q 

< 
O 
CD 




O 
Q 

01 
< 



CD 

cn 
en 

UJ 

a: 
o 
o 

< 




V) 



< 



o 



"^ 






cn 

UJ 

a: 
o 
o 

< 



00 

< 

< 



A 



± 



ayvoa ysHioiM oi 



SCHEMATIC ROM CARTRIDGE 




A0 
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A3 
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-l-S 
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Al 




oa 






01 






02 




RIGHT 
A602 


03 
04 
OS 






06 
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(AI2)CS 
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APPENDIX A 

USE OF player/m:i3SIle graphics 

WITH BASIC 



The ATARI ® 400/ 800 ™ Hardware Manual should be read first to understand 
the details of the Player/Missile Graphics. 

To enable the P/M Graphics from BASIC the following procedure 
can be used:* 

1. Generate the playfield, either with a GRAPHICS call or build 
a custom display list with a series of POKE statements. 

2. Enable P/M DMA control by a POKE 559 with either a 62 for 
single line resolution players or a 46 for double line 
resolution players. 

3. There are four players and four missiles {or five players if 
the four missiles are combined into one player). Each of 
these has a horizontal position register that controls its 
horizontal position on the screen. The registers and their 
locations are as follows: 

ADDRESS HORIZONTAL POSITION OF 

53248 
53249 
53250 
53251 
53252 
53253 
53254 
53255 

The horizontal positions can range on the playfield between 41 
and 200. So POKE 53249,120 will move Player 1 to the middle 
of the screen. 



Player 





Player 


1 


Player 


2 


Player 


3 


Missile 


1 


Missile 


2 


Missile 


3 


Missile 


4 



*NOTE: All number references are decimal. 
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Use of Player/Missile Graphics 
with BASIC, cont. 



Each player (and its missile) has a color register which 
determines its color. These registers can be controlled by 
poking to the following locations: 



ADDRESS 



COLOR OF 



704 
705 
706 
707 
711 



P/M 
P/M 1 
P/M 2 
P/M 3 
fifth player 



if enabled) 



Thus a POKE 706,200 will color player 2 green. 

The P/M bit information (those bytes which actually describe 
the shape of the player) must be stored in an area where it 
will not interfere with BASIC or the operating system. It 
must also start at a 2K memory boundary if single line 
resolution players are used, or a IK boundary for double line 
resolution players. 

The page number (i.e. number of 256 byte sections of memory) 
for the starting address of the P/M information obtained in 
step 5 is poked into location 54279. 

Enable the P/M DMA by a POKE 53277,3. 

The starting address of each player is obtained by multiplying 
the number obtained in step 6 by 256 and then adding the 
offset indicated in P/M memory configuration table. 

The vertical position of the player is determined by its 
location in memory. After the initial offset is obtained in 
step 8, its height may be defined. Its range on the playfield 
is from 32 to 223 in single line resolution and from 16 to 111 
in double line resolution. By adding the desired height to 
the initial offset, the absolute address of each player is 
found. The appropriate bit information for the player can now 
be poked into this address. 
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Use of Player/Missile Graphics 
with BASIC, cont. 



9 , cont . ) 



Example to Generate a rectangular box player, eight color 
clocks wide and four lines high in immediate mode. 



RESULT 

Setup Mode 8 Play field 

Enable P/M DMA single line 

Set horizontal position 

Set color to pink 

Get P/M base address 

Store in base register 

Enable P/M DMA 

Get player starting address 

Draw player on screen 



STEP 


TYPE 


1 


GRAPHICS 8 


2 


POKE 559, 62 


3 


POKE 53248,120 


4 


POKE 704,88 


5 


I = PEEK (106) -8 


6 


POKE 54279,1 


7 


POKE 53277,3 


8 


J = I * 256 + 1024 


9 


POKE J + 125,255 




POKE J + 126,129 




POKE J + 127,129 




POKE J + 128,255 
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Use of Player/Missile Graphics 
with BASIC, cont. 



CN 

O 



+0 



DMACTL 
bit D4=0 



start at 
PMBASE*X024a5b 



mACTL 
bit D4=l 



start at . 
PMBASE * -^QAQJ^U 



+0 



+384 


-^- 8 bits wide — "^ 

384 bytes 
unused 


^—8 


bits wide -"* 

768 bytes 
unused 


+512 


M3 


M2 


Ml MO 




+640 


Player 


+768 


Player 1 


+896 


Player 2 


M3 


M2 


Ml 


MO 


+1024 


Player 3 




128 bytes 
per player 


Player 




^- -yy ^ 

double line 
resolution 


Player 1 




Player 2 




Player 3 



+768 



+1024 



+1280 



+1536 



+1792 



+2048 



PLAYER-MISSILE 

Memory 
Configuration 



Absolute address 
^ determined by 
PMBASE. 

Relative address 
shown along sides 
of maps. 

Each Player-Missile 
section (128 bytes 
in single line, 256 
bytes in double line) 
maps directly onto 
the total height of 
^^ TV screen. 

0) 
4J 



CO 

o 

CN 



256 bytes 
per player 



single line 
resolution 



A 



■4- 



APPENDIX B 

MIXING GRAPHICS MODES 



I . GENERAL 

This procedure describes how to mix several graphic modes on 
the TV screen at the same time using BASIC commands. Each graphics 
mode has a different number of scan lines per "Mode Line" (one line 
of a graphics mode). The TV screen must consist of 192 scan lines, 
so when mixing modes, they must be combined in'such a way as to get 
192 scan lines. This is accomplished by modifying the Display 
List. 

When a graphics mode is set on the computer, the O/S allocates 
RAM space for the graphics mode, then builds the, display list 
adjacent to the graphics RAM, and sets a pointer to the beginning 
of the display list. Each "mode line" is constructed from a "mode 
byte" in the display list that determines how many scan lines in 
each mode line. The display list describes the screen display from 
top to bo 1 1 om . 

A Display List must be built for the "max RAM mode" (the 
graphics mode that requires the most RAM) then modified with POKES 
to mix the other modes with it. This "max RAM mode" cannot be a 
split screen mode (text window), therefore "max RAM mode" +16 must 
be used. If the max RAM mode will be at the top of the screen, then 
the "LMS byte" (load memory scan byte) at the top of the Display 
List will already be correct. If not, the "LMS byte" will have 
to be modified. 

The Display List is modified by POKING a new mode byte for 
each mode line that is not a max RAM mode line. At the end of the 
display list is a JUMP instruction pointing to the top of the 
Display list. When the Display List is modified, the JUMP instruc- 
tion must be placed immediately after the last mode byte. 

Example #1 will be used throughout this procedure to 
illustrate each step. 
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N(^RN^AL 



TV 6C\^e£N 



\MOiFlEO 



96 



Z^ i?2 



YYVOQ£ 7 
76 L\ue^ 



TOTAL = /92 



tlWES 



mooe 1 

6 L^MCi 



moDe 7 



Z LINt£5 



6 kS-^ q^ 



Si^XZ =1/2. 



7.y /G - 3 



^ 



TOTA L = 1^2. 



moO£i 



2 

3 



Mope 7 



Y 



Yr\00£ 7 

OlSV^LAV 
LI6T 



(H£X^ 



C^D) 



DEC 



77 



LO 



HI 



C(^D> »3 



(ZJO) 



C^d) 13 






'3 



>o 
HX 



CCrt Si 

Line ^ 



~^ — (Lr>\s I3VT£)_ 



2 



Y 
1^2 



mooE 

(oLlUES 






^ 1 



moD£ 7 



moo£ i 



exAm^LE '^X 



3 



7 

i 



43 



^O0\f lED 
vaodc 7 

LIST 



(WEX^ 


0£C 


(fM^) 


7^ 


LO 


HI 


CciJfe^ 


G 


(25<^^ 


G 


<:c^<c,') 


C» 


C04^ 


^ 


(^0 


6 


COiJD^ 


/3 


C0D) 


13 




(.^^ 


/3 


dCzJD) 


/3 


(07) 


7 


(aJ7) 




(^0 


LO 


HX 


X 






/c. 



1 



17^ 
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Mixing Graphics Modes, cont. 



II. PROCEDURE TO SET UP SCREEN IN MIXED MODES ; 

1. Select modes desired, then look up which mode is the max 
RAM mode from table #2. 

example: modes selected - mode 1, mode 7, mode 2 

mode 7 = max RAM mode 

2. Use table //I to calculate the number of mode lines such 
that the total number of scan lines = 192. 



example : 



1 1 scan 1 
1 1 lines 1 
I # mode 1 per | scan 
mode 1 line 1 mode | lines 
1 1 line 1 


11 6 1 8 1 48 


7 1 56 1 2 1 112 


2 1 2 1 16 1 32 



192 



TOTAL 



3. If the max RAM mode is at the top of the screen, then skip 
this step: Calculate the LMS byte by setting the left 
nibble to 4, then use table #1 to find the right nibble for 
the graphics mode at the top of the screen. 

example: 1. left nibble = 4 

2. right nibble for mode 1=6 

3. LMS byte = 46 (HEX) 

4. Calculate the mode byte for each mode. Set the left nibble 
to 0, use table // 1 to find the right nibble for each mode. 

example : 



1 Left 1 Right | Mode 
Model Nibble! Nibblej Byte 
1 1 1 (HEX) 


1 1 1 6 1 06 


7 1 1 D i OD 


2 10! 7 1 07 
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Mixing Graphics Modes, cont. 



II* PROCEDURE TO SET UP SCREEN IN MIXED MODES , cont.: 
5. Convert all bytes to decimal. 
example : 



Bvte 


(HEX) 


DEC 


LMS 


46 


70 


Mode 1 


06 


6 


Mode 7 


OD 


13 


Mode 2 


07 


7 



6. Execute a graphics call on the computer using the max RAM 
mode (+16). 

example: GRAPHICS 7+16 

7. PEEK the Display List pointer and use it to calculate a 
variable labelled "START". 

example: START = PEEK(560) + PEEK(561) * 256 + 4 

8. If the max RAM mode is at the top of the screen, then skip 
this step: Poke the LMS byte to location START-1. 

example: POKE START-1, 70 

9. Every mode line requires a mode byte in the Display List in 
the same order as the mode lines appear on the screen. The 
mode bytes must be POKED into the Display List at location 
START + offset, where offset = mode line //. 



Example : 

MODE 1 

MODE 7 
MODE 2 



MODE LINE // 

2 
3 
4 
5 
6 



POKE INSTRUCTION 

POKE START +2,6 

POKE START +3,6 

POKE START +4,6 

POKE START +5,6 

POKE START +6,6 



see note for mode 7 (max RAM mode) 



63 
64 



POKE START + 63,7 
POKE START + 64,7 



NOTE: The Display List will already be correct for the max RAM 
mode, therefore its mode bytes do not need to be POKEd. 
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Mixing Graphics Modes, cont. 



II. PROCEDURE TO SET UP SCREEN IN MIXED MODES , cont.: 

10. POKE the JUMP instruction followed by the LO byte, then the 
HI byte into the Display List. The offset for the JUMP 
POKE is the last mode line # + 1, for LO byte it is + 2, 
for HI byte it is + 3. 

example: (last mode line # was 64) 

REMARK POKE INSTRUCTION 

JUMP POKE START + 65,65 

LO BYTE POKE START + 66, PEEK(560) 

HI BYTE POKE START + 67, PEEK(561) 



III. PROCEDURE TO PRINT AND PLOT IN MIXED MODES 



1. If the mode line #'s of a mode on the screen fall within 
the range of that mode's normal mode line // ' s then use the 
following procedure: 

a. POKE 87 with the mode // 

b. Determine the Y coordinate by counting the # of mode 
lines from the top of the screen to the current 
position. 

c. Determine the X position in the normal manner for that 
mode . 

d. Depending on the mode, either PLOT and DRAWTO , or 
POSITION and PRINT. 

e. These steps must be done for each mode on the screen 
that meets the condition in step 1. 

example: MODE 1 POKE 87,1 

POSITION 2,1:PRINT #6;"TEXT" 

MODE 7 POKE 87,7 

COLOR 1:PL0T 20,20:DRAWTO 30,30 

MODE 2 See step 2 
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Mixing Graphics Modes, cont. 

III. PROCEDURE TO PRINT AND PLOT IN MIXED MODES , cont. 

2. Some modes may have mode line #'s outside of their normal 
range . 

example: Mode 2 normally has mode line #'s 1 through 12 
(full screen). These are modified to #63 and 
#6 4 in example #1. 

To prevent the computer from giving a "cursor out of range" 
error message the following procedure can be used: 

a. Set a variable labelled "MEMST" to be the display 
memory start pointer. 

MEMST = PEEK(START) + PEEK(START + 1) * 256 

b. Set a variable labelled CHRPOS to position characters 
to be printed on the target line. 

CHRPOS = MEMST + [ (Mi - 1 ) *R-M2 * (R-2 0) -M3 * (R- 1 0) ] +X 

Where : 

X = horizontal position of character on the target 

line. 
R = the RAM per line of the Max RAM Mode (table #1). 
M^= the Mode Line # of the target line. 
M^ = the number of mode lines of 20 bytes of RAM per 

line above the target line. 
M3 = the number of mode lines of 10 bytes of RAM per 

line above the target line. 

Example; calculate CHRPOS for Mode Line #64 (the 

last line of the Mode 2 area) at horizontal 
posit ion 5 . 

X = 5 

R = 40 

Mj =64 

M = 7 (6 from Mode 1 area, 1 from Mode 2 area). 

M3 = 

CHRPOS = MEMST + [ ( 6 4- 1 ) *40- 7* ( 40-2 0) -0* ( 40- 1 ) ] +5 

CHRPOS = MEMST + [ ( 6 3 ) *40-7* ( 2 ) -0* ( 30 ) ] +5 

CHRPOS = MEMST + [2520 - 140] + 5 

CHRPOS = MEMST + [2380] + 5 

CHRPOS = MEMST + 2385 
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Mixing Graphics Modes, cont. 



III. PROCEDURE TO PRINT AND PLOT IN MIXED MODES , cont. 



2. 



cont 
c . 



If few characters will be printed, then each character's 
internal value may be looked up in the Internal 
Character Set Table (Table 9.6), in the new BASIC 
Reference Manual. This value is then POKED into 
CHRPOS. 

If strings are to be output, and if the ATASCII values 
of all the characters lie within one of the ranges 
shown in the table below, then do the following: 

1) Obtain the appropriate ATASCII value range for 
the characters 

2) Do the OPERATION the table indicates on the 
ATASCII value of each character. 

3) POKE this value into CHRPOS. 



ATASCII VALUE 




RANGE 


OPERATION 


0-31 


Value + 64 


32-95 


Value - 32 


96-127 


NONE 


128-159 


Value + 6 4 


160-223 


Value - 32 


224-255 


NONE 



Example: 1) 

2) 
3) 

4) 



assume we want to print the word "TEXT" 

in the mode 2 area of example #1 using 

the CHRPOS calculated previously. 

these characters are in the ATASCII 

VALUE RANGE of "32 - 95". 

the OPERATION for this range is "Value-32", 

so 32 must be subtracted from each 

ATASCII value. 

the program statements would now look 

like this: 

T$(l,4) = "TEXT" 
CHRPOS = MEMST + 2385 

FOR X = 1 TO LEN(T$) 

POKE CHRPOS + X - 1, ASC[T$(X,X)] - 32 

NEXT X I I 

(OPERATION: value - 32) 



5) the FOR/NEXT loop POKEs the first 
character of T$, ASC [T$ ( X, X) ] -3 2 , into 
CHRPOS + 0. 

6) the next iteration POKEs the next 
character of T$ into the next CHRPOS, 
and so on. 
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Mixing Graphics Modes, cont. 

TABLE in 

MODE BYTE 



1 ^ 1^ 1 I SCAN ! ! ! 

1 LEFT ! 1 RIGHT ! CCJ LINES | j 1 RAM 

remark! nibble! j nibble! per 1 per | # 1 mode! per 

1 (HEX) 1 1 (HEX) 1 pixel! MODE ! COLORS! j LINE 

1 ! ! ! ! LINE 1 i ! 


^1 ! 1 2 1 ^ 1 8 ! L^o CD! 1 40 


CU ! 4 ! CHAR 1 3 1 h 1 10 ! 1% 1 - ! 40 


1 ! 1 4 ! 1 ! 8 ! 4 ! - ! 40 


_ ! ! MODES 15 1 1 1 16 1 4 | - | 40 


C2j ! ! ! 6 ! 1 1 8 1 5 1 1 1 20 


1 1 I 7 ! 1 1 16 1 5 1 2 1 20 


! ! !8!4!8|4|3|10 


_! ! |912!412!4|10 


Cl) ! 4 1 GRAPHIC! A ! 2 1 4 ! 4 ! 5 | 20 


! 1 1 b 1 1 ! 2 1 2 ! 6 ! 20 


! ! MODES 1 C I 11 11 2 1 - 1 20 


! ! ! D 1 1 1 2 1 4 ! 7 1 40 


(2) ! ! ! E ! 1 1 1 i 4 1 - 1 40 


1 1 ! F ! ^ 1 1 1 1?5 1 8 1 40 


blank! 0-7 I ® ! ! blank! - 1 - 1 - ! - 


JUMP ! 4 ! special! 1 1 JUMP 1 - 1 - ! - ! - 



Clj When the max RAM mode is not at the top of the screen, the 
left nibble of the LMS byte must be changed to a 4. 

^2^ Left nibble for all mode bytes after the LMS byte. 

^3^ Color & Lum for the field is controlled by Setcolor 2, and 
Lum for charactors or graphics from Setcolor 1. 



© 



4.) JUMP - used to end the display list and return to the 
beginning. 

BLANK - to outout selected number of background lines. 
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Mixing Graphics Modes, cont» 

TABLE #2 

GRAPHICS MODES 
RAM REQUIREMENTS 



Mode 8+16 
8 

7 + 16 
7 

6 + 16 
6 

5 + 16 
5 

4+16 
4 

3+16 
3 

2+16 
2 

1 + 16 
1 




8138 Bytes 

81 12 

4200 

4190 

2184 

2174 

1176 

1174 

696 

694 

432 

434 

420 

424 

672 

674 

992 



These values include the display list and any imbedded 
unused memory blocks. 
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RAM 
bytes 



W 
I 

M 
O 



1024 1 








MEMORY CONFIGURATIONS 






-*- 










FOR MODES - 4 






Decreasing 


32 bytes OL 




RAM 






760 — 




























54 bytes DL 


56 bytes DL 




34 bytes DL 


32 bytes DL 




960 














512 — 


bytes 

character 

map 


400 

bytes 

character 

map 


480 

bytes 

character 

map 






400 

bytes 

bit 

map 


480 

bytes 

bit 

map 




24 bytes DL 


20 bytes DL 


34 bytes DL 


32 bytes DL 


— 


















200 


240 


200 


240 














bytes 
bit 


bytes 
bit 


bytes 
bit 


bytes 
bit 






256 — 








map 


map 


map 


map 








80 bytes 
unused 


80 bytes 
unused 




40 unused 


40 unused 


Top of 
Free 
RAM 

-•- 




160 bytes 

text 
window 


160 

bytes 

unused 


160 bytes 

text 
window 


160 
bytes 
unused 


160 bytes 

text 
window 


160 

bytes 

unused 


160 bytes 

text 
window 


160 

bytes 

unused 



MODE: 



1+16 



2 + 16 



3 + 16 



4 + 16 



MEMORY CONFIGURATIONS 
FOR MODES 5 - 8 



RAM 
Bytes 



8192' 



Decreasing 
RAM 



6144- 



4096 



2048- 



Top of 
Free 
RAM 



94 bytes PL ~^ 1 04 bytes PL -^ 



54 bytes DL -^ 56 bytes PL 



800 bytes 
bit map 



160 unused 



160 text 



960 bytes 
bit map 



MODE: 



160 unused 



5 + 16 



1600 

bytes 

bit 

map 



320 unused 



160 text 



1920 

bytes 

bit 

map 



160 unused 
6 + 16 



94 bytes PL -^ 104 bytes DL-^ 



96 unused 



3200 

bytes 

bit 

map 



640 bytes 
unused 



160 text 



96 unused 



3840 

bytes 

bit 

map 



160 unused 



7 + 16 



1 76 bytes DL -^ 202 bytes PL -^ 



80 unused 



6400 

bytes 

bit 

map 



1280 

bytes 

unused 

1 6 unused — 



160 text 



80 unused 



■z^ 



7680 

bytes 

bit 

map 



16 unused - 



160 unused 
8+16 



APPENDIX C: PINOUTS 



Monitor Jack (800 only) 

D.I.N. 5 Jack 

Audio Output 
Composite Chroma 
Ground 

Serial I/O Jack 




Composite Luminance 



Composite Video 



10 12 



11 13 



1 . Clock Input 

2. Clock Output 

3 . Data Input 

4. Ground 

5 . Data Output 

6 . Ground 

7 . Command 



9 
10 
11 
12 
13 



Motor Control 
Proceed 
+5/Ready 
Audio Input 
+12 volts 
Interrupt 



Controller Jack 




1. (Joystick) Forward Input 

2. (Joystick) Back Input 

3. (Joystick) Left Input 

4. (Joystick) Right Input 

5. B Potentiometer Input 



6 . Trigger Input 

7. +5 volts 

8 . Ground 

9. A Potentiometer Input 
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